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Introduction 


Overview 

The V/SCSI-2 4220 Cougar 11 is available as a Fast or Fast and Wide SCSI-2 controller. The Cougar II 
is capable of controlling any combination of up to 14 SCSI-2 devices, seven on the primary SCSI channel 
and seven more if the optional secondary SCSI channel Is installed. The Cougar II Wide is capable of 
controlling any combination of up to 15 Fast or Fast and Wide devices per channel. 

If you have the Cougar II Wide product, the extensions to the MACSI SCSI interface necessary to support 

fast and wide SCSI operations are defined throughout this manual (identified with a VI\v\ the left margin). 
These extensions are defined to be fully upward compatible with existing drivers, therefore no changes are 
required to maintain the current level of functionality. 


System Interface 

The host processor communicates with the Cougar through 256, 512, IK, or 2K bytes of onboard RAM. 
All commands and responses pass through this memory space which Is referred to as Short I/O because 
it is mapped into the Short I/O space of the VMEbus. 

Each command to the Cougar is specified using a host-generated software structure called an Input/Output 
Parameter Block (lOPB). lOPBs can be built in either the Cougar’s Short I/O space or offboard in system 
memory. In the latter case, command completions may optionally be posted to both onboard and offboard 
data structures. 

The system-level interface, referred to as MACSI (Multiple Active Command Software Interface), is 
implemented in Short I/O. In addition to supporting command queuing, MACSI enables multiple commands 
to be active simultaneously. The Cougar accepts commands from the host and queues them internally. 
It then acts on each command as soon as possible within the confines of the SCSI bus. As commands 
are completed, the board notifies the host of each command’s completion as well as the completion status. 


Issuing Commands 

The host submits commands to the Cougar by making an entry into a circular queue called the Command 
Queue. Each Command Queue entry is a 12-byte block containing a pointer to the lOPB and other control 
information. 

The host may build lOPBs either onboard (in the Cougar’s Host Usable Space in Short I/O) or offboard in 
system memory. Once It builds an lOPB, the host creates an entry for the lOPB in the next available slot 
in the Command Queue. 


Work Queues 

The concept of work queues is integral to the way that MACSI allows multiple commands to be active 
simultaneously. Information in the Command Queue entry determines the work queue into which a 
particular command is placed. At any time, there is an In Progress command for each work queue that 
has at least one entry. The Next command waits for the In Progress command from that work queue to 
complete. 
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The Cougar li accommodates up to 14 work queues and the Cougar II Wide up to 255 work queues. This 
is not counting a special queue called Work Queue 0. Work queue 0 is intended for issuing special 
commands such as initialize controller or error recovery, etc. Cougar II Wide supports up to 255 work 
queues, numbered 0 through 255. Work queues are Intended to be dedicated to a specific SCSI-2 device. 
Multiple work queues may be dedicated to the same device. The host sets the paramenters of each work 
queue when it initializes the queue. 

Since the SCSI bus allows many tasks to overlap on multiple devices, the MACSI interface allows for 
commands from all work queues to be interspersed. Assuming that the SCSI devices support overlapped 
activity on the SCSI bus (using Disconnect/Reconnect), one In Progress command for each attached SCSI 
device can be simultaneously active, resulting in overlapped data streams. Since the Cougar can have two 
fully independent SCSI buses, it can support two truly simultaneous data streams. If some devices do not 
support overlapped activity, they can be relegated to the optional second channel, allowing fully functioning 
devices on the primary channel unrestricted operation. Both channels can, of course, support full SCSI 
functionality. 


Executing Cammcmds 

The Cougar reads the Command Queue, determines which entry to execute next, and moves the 
appropriate Command Queue entry and lOPB into one of its internal work queues. Commands intended 
for a specific device are sent to the work queue dedicated to that device. 

After the Command Queue entry and IQPB are placed into a work queue, the slot in the Command Queue 
formerly filled by the command becomes available for re-use by the host. Even In the unlikely case that 
the Command Queue is full when the host tries to enter a command, the Cougar provides efficient 
operation by optionally interrupting the host when an entry becomes available in the Command Queue. 

Once the command is moved to the appropriate work queue, it is executed at the first opportunity. The 
Cougar then posts command completion to the Command Response Block (CRB) in either Short I/O or 
system menrxjry, and generates an optional interrupt. The host acknowledges the command completion 
by writing a word to the CRB, releasing it for further use. 


Master Command Entry and Work Queue O 

In order to initialize the board, as well as to execute high priority commands, the Cougar provides two auto- 
initialized facilities: the Master Command Entry and the Work Queue 0. 

The Master Command Entry and Work Queue 0 allow a single command to be issued and the host to poll 
for its completion before issuing the next one. This mechanism is used, upon power-up, to initialize the 
rest of the work queues for normal SCSI operations, and in error recovery operations. 
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VME / VME64 BUS 


Figure 1-1. V/SCSI-2 Cougar li Block Diagram 
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Chapter 2 
Installation 


Overview 

To insure safe installation, read this chapter thoroughly before attempting installation of either the V/SCSI-2 
4220 Cougar II motherboard or the V/SCSI-2 4220 Cougar II Wide motherboard into your system. If you 
have any questions regarding installation which are not ariswered in this chapter, please contact Interphase 
Customer Service at (214) 919-9111. 

The boards are installed into the VMEbus system using the following steps: 

1. Visual Inspection 

2. Fuse And Diagnostic LEDs 

3. Set Motherboard Jumpers 
3a. Cougar II 

3b. Cougar II Wide 

4. Set Motherboard Termination 

5. Set Daughter Card Jumpers And Termination 
5a. Single-Ended SCSI-2 Daughter Card 

5b. Differential SCSI-2 Daughter Card 
5c. Differential SCSI-2 Wide Daughter Card 
5d. Printer (Short Line) 

5e. Printer (Long Line) 

6. Cabling Procedure 

7. Installing the Board 
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WARNING 


1. Catastrophic DAMAGE can result from improper connections. 
Therefore, those planning to connect power sources to the VMEbus 
to feed the user-defined 96 pins of P2 (Rows A and C) should 
FIRST CHECK to ensure that all boards installed are compatible 
with those connections. 

2. Do NOT install or apply power to a damaged board. Failure to 
obsenre this warning could result in extensive damage to the board 
and/or system. 

3. Caution! The controller is extremely sensitive to electrostatic 
discharge (ESD), and the board could be damaged if handled 
improperly. Interphase ships the board enclosed in a special anti¬ 
static bag. Upon receipt of the board, take the proper measures to 
eliminate board damage due to ESD (i.e., wear a wrist ground strap 
or other grounding device). 


The installation procedure will vary depending on the desired configuration. Variables include: 

• One or two SCSI channels (up to 7 devices per channel for a Fast SCSI-2 channel, and up to 15 
devices for a Fast and Wide SCSI-2 channel). 

• Single-ended vs. differential SCSI operation for each channel. 

• Fast SCSI-2 vs. Fast and Wide SCSI-2 I/O for the SCSI daughter card, if any. 

• Use of a printer port daughter card instead of a second SCSI channel. 

Table 2-1 summarizes the 4220 Cougar 11 board products available from Interphase to implement various 
combinations of the above functions. The SCSI Bus drivers on the above products are not convertible. 
That is, a board with single-ended SCSI drivers cannot be converted to differential, and vice versa. 
However, a single-ended rrwtherboard can have a differential daughter card, and a differential motherboard 
can have a single-ended daughter card. 

NOTE: The jumper designations differ on the Cougar 11 and the Cougar II Wide board layouts. Refer to 
page 2-28 for the Cougar II and page 2-19 for The Cougar II Wide. 
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Table 2-1 4220 Cougar il Wide Products 


PRODUCT 

DESCRIPTION 

Single-ended V/SCSl-2 4220 Cougar II Motherboard 

Provides one single-ended SCSI channel with 8-bit 

SCSI I/O. Signals are routed off P8. 

Differential V/SCSI-2 4220 Cougar II Motherboard 

Provides one differential SCSI channel with 8-bit SCSI 

I/O. Signals are routed off P8. 

Single-ended V/SCSI-2 4220 Cougar II Wide Motherboard 

Provides one single-ended SCSI channel with 16-bit 

SCSI I/O. Signals are routed off P8. 

Differentieil V/SCSI-2 4220 Cougar II Wide Motherboard 

Provides one differential SCSI channel with 16-bit SCSI 

I/O. Signals are routed off P8. 

Fast and Wide Single-ended SCSI-2 Daughter Card 

Adds one single-ended SCSI channel with 16-bit SCSI 

I/O to any 4220 motherboard. Signals are routed off 

Pi 3. 

Fast and Wide Differential SCSI-2 Daughter Card 

Adds one differential SCSI channel with 16-bit SCSI I/O 
to any 4220 motherboard. Signals are routed off Pi3. 

Fast Single-ended SCSI-2 Daughter Card 

Adds one single-ended SCSI channel with 8-bit SCSI 

I/O to any 4220 motherboard. Signals are routed off 

PI 3. 

Fast Differential SCSI-2 Daughter Card 

Adds one differential SCSI channel with 8-bit SCSI I/O 
to any 4220 motherboard. Signals are routed off Pl3. 

Centronics/Short Line Daughter Card 

Adds one Centronics Short Line Printer Port to any 

4220 motherboard. Signals are routed off P9. 

Dataproducts Long Une Daughter Card 

Adds one Dataproducts Long Line Printer Port to any 

4220 motherboard. Signals are routed off P9. 




























P8 is a 68-pin micro D “P” connector 
P7 is a 50-pin ribbon ''A” connector 


Figure 2-1 V/SCSI-2 4220 Cougar II Single-Ended Board Layout 





























IfistcLllatioTi 



NOTE: RP7 and RP9 (not pictured) are not SCSI Terminators, Do not remove. 
P8 is a 68-pin micro D connector 
P7 is a 50-pin ribbon 'W connector 


Figure 2-2 V/SCSI-2 4220 Cougar 11 Differential Board Layout 
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NOTE: P8 is a 68-pin micro D connector 
P7is a 50-pin ribbon connector 


Figure 2-3 V/SCSI-2 4220 Cougar il Wide Single-Ended Board Layout 
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NOTE: P8 is a 68-pin micro D “P” connector 
P7 is a 50-pin ribbon connector 
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COUGAR il & COUGAR II WIDE COUGAR II & COUGAR II WIDE 


InstiMllcLtian Procedure: V/SCSI-2 4220 Cougar H Mofherbotird 

Proper installation of the Cougar 11 motherboard (hereafter referred to as the Cougar It) requires the 
following seven step procedure. Follow step 3a for the Cougar II and step 3b for the Cougar II Wide 
motherboard. Skip step 6 if you do not have a daughter board. 


Step i. Visual Inspection 

Always wear an anti-static or grounding device before attempting the installation of this board. Remove 
the board from the anti-static bag, and visually inspect H to ensure no damage has occurred during 
shipment. A visual inspection is usually sufficient, since Interphase thoroughly checks each board just 
prior to shipment. After verifying the presence of ail parts and the condition of the board, proceed with 
the installation. 


Step 2. Fuse And Diagnostic LEDs 
Fuse 

The Cougar 11 board uses a 1.5A fuse (part number LITTELFUSE 273-01.5) (FI) to protect the SCSI 
terminator power when provided by the Cougar. Refer to the board layout to determine the location 
of the fuse on the board. 


Diagnostic LEDs 

This motherboard has 7 board status LEDs mounted on the corrponent side of the board. Refer to 
the board layout illustrations (Figures 2-1 and 2-2) on pages 2-4 and 2-5 for the location and 
identification of the LEDs. Table 2-2 summarizes the function of these LEDs. 
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COUGAR il & COUGAR il WIDE 


COUGAR II & COUGAR II WIDE 


Table 2-2 V/SCSI-2 4220 LEDs 


DESIGNATOR 

FUNCTION 

LED1 

Board Status 0 (LSB) 

LED2 

Board Status 1 

LED3 

Board Status 2 

LED4 

Board Status 3 (MSB) 

LEDS 

Board OK (Red/Green) Green = Board OK 

LED6 

Terrn Power (On = OK) 

LED7 

SCSI Bus Busy (On s Busy) 


Board Status l^Os 

LEDs 1, 2, 3 and 4 are Board Status LEDs providing the following functions: 

• Power On Self Test (POST) Mode 

• Monitor Mode 

• Run Mode 

POST Mode: Provides diagnostics for the CPU and Buffer. Refer to Table 2-3 for a list of 
diagnostics performed while in this mode. The time required for the board to complete normal 
power-up diagnostics is approximately 200 milliseconds. 
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COUGAR II & COUGAR 11 WIDE COUGAR II & COUGAR II WIDE 


Table 2-3 Board Status Diagnostics Used In POST Mode 


HEX CODE 

DIAGNOSTICS 

DERNITION 

TYPE OF TEST 

0X01 

CPU Register Test 

CPUFAIL 

CPU Core Test 

0X02 

ROM Checksum Test 

ROMFAIL 

CPU Core Test 

0X03 

Walking 1’s SRAM 

STAT1FAIL 

CPU Core Test 

0X04 

Walking O's SRAM 

STATOFAIL 

CPU Core Test 

0x05 

Decrementing Longwords 

STATLFAIL 

CPU Core Test 

0X06 

Word Access 

STATWFAIL 

CPU Core Test 

0X07 

Byte Access 

STATBFAIL 

CPU Core Test 

0X08 

Reserved 

RESERVED 

CPU Core Test 

0x09 

Walking 1's In Buffer 

BUFFERFAIL1 

Static Buffer Test 

OxOa 

Walking O's In Buffer 

BUFFERFAILO 

Static Buffer Test 

OxOb 

Decrementing Longwords 

BUFFERFAIL 

Static Buffer Test 

OxOc 

Walking 1‘s,0’s VME DMA 

VMEFAIL 

Control Register Access 

OxOd 

Mothertsoard FEC Tests 

FEC0& 1 

Control Register Access 

OxOd 

Daughter Card FEC Tests 

FEC2&3 

Control Register Access 


Monitor Mode: LEDs sequentially flicker when Serial Port A is active and On-Board monitor controls 
the board. 

Run Mode: The board accepts commands from the host. If all LEDs are extinguished, no 
commands are on the Cougar and the board is completely idle. Refer to table 2-4 for a complete 
definition of the Board Status LEDs in the Run Mode. 


Table 2-4 Run Mode LED Matrix 


LED1 

LED2 

LED3 

LED4 

FUNCTION 

ON 

OFF 

OFF 

OFF 

1-4 Commands On Board 

ON 

ON 

OFF 

OFF 

5-16 Commands On Board 

ON 

ON 

ON 

OFF 

17-64 Commands On Board 

ON 

ON 

ON 

ON 

65 or More Commands On Board 
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COUGAR II 


COUGAR 11 


Step 3a. Check Cougctr n Botird Jumpers 

Check all onboard, user-configurable jumpers for proper (x>nfiguration for your system. The 
motherboard layouts on pages 2-4 and 2-5 show the jumper locations for the Cougar II Single- 
Ended and Differential motherboards. (For Cougar It Wide jumper settings, skip to step 3B). 


BSotherixKird Jumper Settings 

The following are jumpers and the default settings used on the motherboard. 

NOTE: Jumpers which are not described are not user-configurable and should remain as set at 
the factory. 


J3 REMOTE LED CONNECTOR: Used to cable LEDs to a 9U front panel (Optional). 


|8. 

|L__ 


1 

1 ♦ 

II 

• li 

II 

1 • 

1— 

• B 

II 

R 1 

iLj 

II 

-111 


Table 2-5 J3 Remote LED Connector Pinout 


PIN 

DESCRIPTION 

1 

LED 3 

2 

LED 2 

3 

LED 4 

4 

LED 1 

5 

LED 5 (Green) 

6 

LED 5 (Red) 

7 

+5V 

8 

LED 5 ANODE 
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COUGAR II 


COUGAR II 


J4 Terminator Power to Primary SCSI Bus: 

Connects terminator power to the primary SCSI bus. Placing a jumper on J4 connects the 
power. The Cougar li is shipped with the jumper installed on J4 (Default is ON). 


J10 Firmware Options: 


II I I j li 


ii *21 • 

II 1 

• 

• 8 

II I 

l-M- 1 

L:J 

• 7 


JIO 


(Pins 1-2) 16-Bit Block Mode Enabled (Default is OFF) 
ON : 16-Bit Block Mode Disabled 
OFF: 16-Blt Block Mode Enabled 

(Pins 3-4) SysFail (Default is OFF) 

ON : Clear SysFail after passing Power-up Diagnostics 
OFF: Clear SysFail before running Power-up Diagnostics 

(Pins 5-6) Reset SCSI Bus on Powerup (Default is OFF) 
ON : Disabled 
OFF: Enabled 

(Pins 7-8) GDB Debugger Enabled (Default is OFF) 

ON : Debugger Enabled 
OFF: Debugger Disabled 

J12 SCSI ID & VME Bus Grant Level 



— 


1 1 1 u 

||2. 1 . 

I 

• 

• 

• 

• 1 • I'lSl 

1 I II 

tJ-J 

• 

LU 

-U 

1 1 II 

• 1 • I-ISI 
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COUGAR II 


COUGAR II 


VME Bus Grant (J12 Pins 13-16) 


Table 2-8 VME Bus Grant Settings 


BUS GRANT 

J12 PIN # 

13-14 

15-16 

0 

O 

0 

1 

O 

F 

2 

F 

0 

3* 

F* 

F* 


‘Factory Default 
O « On 
F=Off 


J14 Firmware Options/Secondary Short I/O Size 


• 6 

• 8 

• 5 

II 

• 7 


Firmware Options (J14 Pins 1-4) 

(Pins 1-2) Load Rrmware (Default Is OFF) 

ON : Load Rrmware from on-board buffer 
OFF; Load Rrmware from EPROM 

(Pins 3-4) On-board Monitor Enable (Default Is OFF) 
ON : Stop in monitor after loading firmware 
OFF: Normal Run mode 
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COUGAR II 


Secondary Short i/0 Size (J14 Pins 5-8) 

Table 2-9 Secondary Short I/O Size 


J14 PIN # 

SIZE (BYTES) 

5-6 

7-8 

F 

F 

256 bytes of Secondary Short I/O space 

F 

0 

512 bytes of Secondary Short I/O space 

0 

F 

IK bytes of Secondary Short I/O space 

0* 

O* 

2K bytes of Secondary Short I/O space 


* e Factory Default 

0«0N 

F»OFF 


J15 Firmware Options: 


I— f M 11^ I M l )| 

11 .21 .41 .61 .811 

-flJlS 


LiL 


31 .51 .71 


(Pins 1-2) Delayed Initialization of SCSI Bus (Default is OFF) 
ON : Initialize only after lOPB Command (0x41) 

OFF: Initialize after power-up self-test 

(Pins 3-4) Memory Test Enabled (Default Is OFF) 

ON : Disabled 
OFF: Enabled 


(Pins 5-6) Console Message Disable (Default is OFF) 
ON : Disabled 
OFF: Enabled 


(Pins 7-8) GDB Enable Point (Default is OFF) 
ON : GDB Initialized on Exit 
OFF: GDB Initialized on Reset 
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COUGAR II COUGAR II 


J16 Primary Short I/O Size/Reset Enable 


•21 *41 *61 *81 

-1-1-1-I|J1« 

• 11 .31 .51 .711 


Primary Short I/O Size (J16 Pins 1-4) 

Table 2-10 Primary Short I/O Size 


J16 PIN # 

SIZE (BYTES) 

1-2 

3-4 

F 

F 

256 bytes of Secondary Short I/O space 

F 

0 

512 bytes of Secondary Short I/O space 

0 

F 

1K bytes of Secondary Short I/O space 

O* 

0* 

2K bytes of Secondary Short I/O space* 


* s Factory Default 

O-ON 

F«OFF 


Reset Enable (J16 Pins 5-8) 

(Pins 5-6) Secondary Master Control Register (Default is OFF) 
(Pins 7-8) Primary Master Control Register (Default is ON) 

J17 Secondary Channel Address Modifiers: 

ON : Secondary Channel Address Modifiers 29 or 2D 

OFF: Secondary Channel Address Modifiers 2D only (Default is OFF) 

J18 Primary Channel Address Modifiers: 

ON : Primary Channel Address Modifiers 29 or 2D 

OFF: Primary Channel Address Modifier 2D only (Default is ON) 
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COUGAR li 


J19 VME Bus Grant Input Level 2 Disable 
ON ; Enabled 

OFF: Disabled (Default is ON) 

J20 VME Bus Grant input Level 0 Disable 
ON : Enabled 

OFF: Disabled (Default Is OFF) 

J21 VME Bus Grant Input Level 1 Disable 
ON : Enabled 

OFF: Disabled (Default is OFF) 


J22/J23/J24/J25 Primary Short I/O Base Address 

Table 2-11 shows the jumper settings for the Primary Short I/O base address for the default 2K 
Short I/O size. The tables for the other sizes are in Appendix E, Primary Base Addresses for 
J22/J23/J24/J25, page E-1. 

NOTE: Setting jumper J22 pins 15-16 to ON (O) and ail other pins to OFF (F) will disable 
Primary Short I/O. 

J26/27/28/29 Secondary Short I/O Base Address 

The factory default for these jumpers Is J26 pins 15-16 ON, and all others OFF. Secondary 
Short I/O is disabled. 
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COUGAR II 


Table 2-11 Primary Base Address for 2K Short I/O 



NOTE: O = ON. F = OFF 
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COUGAR li WIDE 


COUGAR II WIDE 


W step 3b. Check Cougar n Wide Jdotherboard Jumpers 


Check ail onboard user-configurable jumpers for proper configuration for operation within your system. 
The location of the jumpers is shown on the Cougar 11 motherboard layouts, Rgure 2-3 (page 2-6) and 
Figure 2-4 (page 2-7). 


MotheiixHird Jumper Settings 

The following are jumpers and the default settings used on the motherboards. 

NOTE: Jumpers which are not described are not user-configurable and should remain as set at the 
factory. 

J3 Remote LED Connector: Used to cable LEDs to a 9U front panel (Optional). 

J5 (Default is OFF) 

J6 (Default Is OFF) 

J7 (Default Is OFF) 

J8 TERMINATOR POWER: 

ON : Supply SCSI terminator power to SCSI Bus (Default is ON) 

OFF: Does not supply SCSI terminator power to SCSI bus 
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COUGAR 11 WIDE 


COUGAR 11 WIDE 


J11 Firmware Options 





H .21 . 

M i 

• 

• 

00 

11 1 

LULL. 

L 

LU 




(Pins 1-2) 16-Bit Block Mode Enabled (Default is OFF) 

ON : 16-Bit Block Mode Disabled 
OFF: 16-B'it Block Mode Enabled 

(Pins 3-4) SysFail (Default Is OF^ 

ON : Clear SysFail after passing Diagnostics 

OFF: Clear SysFail before running Power-up Diagnostics 


(Pins 5-6) Reset SCSI Bus on Power-up (Default is OFF) 
ON : Reset Disabled 
OFF: Reset Enabled 

(Pins 7-8) GDB Debugger Enabled (Default is OFF) 

ON : Debugger Enabled 
OFF: Debugger Disabled 


J13 Secondary SCSI IDA^ME Bus Grant for SCSi>2 Fast Daughter card ONLY 


ir "n 

li -21 


H-1-h 


H1J13 


•151 


(Pins 1-7) Reserved 

(Pins 7-12) Secondary SCSI ID for SCSI-2 Fast daughter card 


NOTE: Not used for SCSI-2 Wide daughter cards. If a Wide daughter card is used, do not populate 
pins 7-12. 
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COUGAR II WIDE 


COUGAR II WIDE 


J15 Firmware Options/Secondary Short I/O Size: 


11 -2 *4 •€{ •8|i 

II -f—H-1-FIJI'S 

II -31 «5| .7|| 

(Pins 1-2) Load firmware (Default is OFF) 

ON : Load firmware from onboard buffer 
OFF: Load firmware from EPROM 

(Pins 3-4) Onboard monitor enable (Default Is OFF) 
ON : Stop in monitor after loading firmware 
OFF: Normal run mode 


(Pins 5-8) Secondary Short I/O size 

Table 2-15 Secondary Short I/O Size 


J15 Pin # 

Size (Bytes) 

5-6 

7-8 

F 

F 

256 

F 

0 

512 

0 

F 

IK 

0* 

0* 

2K* 


* = Factoiy Defawlt 

0«0n 

F*OFF 
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COUGAR li WIDE 


COUGAR II WIDE 


J16 Firmware Options: 


li — I «' I I ' Tl 



(Pins 1-2) Delayed initiation of SCSI Bus (Default is OFF) 
ON : Initialize only after lOPB Command (0x41) 

OFF: Initialize after power-up self test 

(Pins 3-4) Memory test enable (Default Is OFF) 

ON : Disable 
OFF: Enable 

(Pins 5-6) Console message disable (Default Is OFF) 

ON : Disable 
OFF: Enable 

(Pins 7-8) GDB enable point (Default is OFF) 

ON : GDB initialized on exit 
OFF: GDB initialized on reset 
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COUGAR li WIDE 


COUGAR il WIDE 


J17 Primary Short i/0 Size/Reset Enable 


•21 'Al 


'31 .51 .71 


“Tl 

■ 8 || 

mji7 


Table 2-16 Primary Short I/O Size 


J17 Pin # 

Size <Byt 0 s) 

1-2 

3-4 

F 

F 

256 

F 

0 

512 

0 

F 

IK 

O* 

O* 

2K* 


•« Factory Default 

0«On 

F«OFF 


(Pins 5-6) Secondary Master Control Register reset enable (Default is OFF) 
ON : Reset enabled 
OFF: Reset disabled 

(Pins 7-8) Primary Master Control Register reset enable (Default is ON) 

ON : Reset enabled 
OFF: Reset disabled 

J18 Secondary Channel Address Modifiers (Default is OFF): 

ON : Secondary Channel Address Modifiers 29 or 2D 
OFF: Secondary Channel Address Modifiers 2D only 

J19 Primary Channel Address Modifiers (Default is OFF): 

ON : Primary Channel Address Modifiers 29 or 2D 
OFF: Primary Channel Address Modifiers 2D only 
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COUGAR II WIDE 


COUGAR II WIDE 


J20/J21/J22 VME Bus Grant IN: 

J20 (Default is OFF) 

ON : VME Bus Grant IN 2 enabled 
OFF: VME Bus Grant IN 2 disabled 

J21 (Default is OFF) 

ON : VME Bus Grant IN 1 enabled 
OFF: VME Bus Grant IN 1 disabled 

J22 (Default is OFF) 

ON : VME Bus Grant IN 0 enabled 
OFF: VME Bus Grant IN 0 disabled 

J23/J24/J25/26 Primary Short I/O Base Address 

Table 2-20 shows the base address jumper settings for the default 2K Short I/O size. The tables 
for the other sizes are in Appendix F, Primary Base Address for J/23/J24/J25/J26, page ?. 

NOTE: Setting jumper J23 pins 15-16 to ON (O) and all other pins to OFF (F) will disable the 
Primary Short I/O. 

J27/J28/J29/J30 Secondary Short I/O Base Address 

The factory default for these jumpers is J27 pins 15-16 ON and all others OFF. Secondary Short 
I/O is disabled. 
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Table 2-20 Primary Base Address for 2K Short I/O 



NOTE: O = ON. F = OFF 
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COUGAR II WIDE 


COUGAR II WIDE 


Step 4 . Set MotheHxxird Termination 


The SCSI specification requires the bus to be terminated at both ends of the SCSI cable. It does 
not allow any other termination; otherwise, a bus impedance mismatch occurs. 

The primary channel (Channel 0) and optional secondary SCSI channel (Channel 1) are each 
provided with separate terminating resistors. The following statement applies to either channel: If 
the port is at either end of the SCSI cable, the channel’s terminating resistors should be left in 
place. If the port is not at the end of the cable, the termination should be removed. 

All versions of the 4220 Cougar 11 are shipped with termination Installed. These resistors provide 
termination for Channel 0. If Channel 0 Is not at one end of the SCSI cable, remove the Indicated 
terminating resistors from the motherboard (Table 2-18). 


Table 2-18 Motherboard Terminators 


Cougar II Single-ended 

RP7,RP8 


Cougar II Oifferentid 

RP1-RP6 

Do Not Remove RP7, RP9 

Cougar II Wide Single-ended 

RP4-RP6 


Cougar II Wide Differential 

RP1-RP3 



St^ 5 . Set Daughter Ckaxi Jumpers And Termination 

If your setup includes a daughter card, it may be necessary to set the card’s jumpers and/or 
termination. Skip to Step 6 if you do not have a daughter card. 


Table 2-19 Single Ended Wide Daughter Card LEDs 


DESIGNATOR 

FUNCTION 

DESCRIPTION 

LEDl 

SCSI BUSY 

When illuminated, indicates BSY is asserted on the 
secondary SCSI bus (channel 1). 

LED2 

TERMPWR 

When Illuminated, indicates TERMPWR is OK. 
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SINQL^-ENDED DAUGHTER CARD 


SINGLE-ENDED DAUGHTER CARD 


5cl Single-Ended SCSI’2 Daughter Card 


Jumpers Used On Single-Ended SCSI-2 Daughter Card 


Component Side 



Figure 2-5 Single-Ended SCSI-2 Daughter Card 
P4 - Terminator Power to Secondary Bus: 

P4 is used to connect terminator power to the secondary SCSI bus. Placing a jumper in P4 
connects the power. The card is shipped with a jumper installed in P4 (Factory Default Setting). 



P4 
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DIFFERENTIAL DAUGHTER CARD DIFFERENTIAL DAUGHTER CARD 

Terminatum On Single-Einded SCSI‘2 Daughter Card 

On the Single-Ended Daughter Card, the SIP terminating resistors are labelled RP1 and RP2. If 
channel 1 is not at the end of the SCSI cable, REMOVE THESE TERMINATORS from the 
daughter card. 


Fuse 

The daughter card has a 1.5A fuse (F1) (part number LITTELFUSE 273-01.5), used to protect 
the SCSI terminator power when provided by the card. 


USDs on Single-Ended SCSI-2 Daughter CUnd 

The Single-Ended Daughter Card has 2 LEDs. Refer to Table 2-20 for a description of the 
LEDs. 


Table 2-20 Single-Ended Daughter Card LEDs 


DESIGNATOR 

FUNCTION 

DESCRIPTION 

LED1 

TERMPWR 

When illuminated, indicates TERMPWR is OK 

LED2 

SCSI BUSY 

When illuminated, indicates BSY is asserted on 
the SCSI bus. 
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DIFFERENTIAL WIDE DAUGHTER CARD 


5b. Differenticd SCSI-2 Daughter Card 


Jumpers Used On Differential SCSI-2 Daughter Card 


Component Side 



Figure 2-6 Differential SCSI-2 Daughter Card 


P4 - Terminator Power to Secondary Bus: 

P4 is used to connect terminator power to the secondary SCSI bus. Placing a jumper in P4 
connect the power. The card is shipped with a jumper installed in P4. 


■■■1 

1 1 

□j 

u 

u 


P4 
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DIFFERENTIAL DAUGHTER CARD DIFFERENTIAL DAUGHTER CARD 


Termincitum On Differential SCSI-2 Daughter Card 

On the Differential Daughter Card, the terminating resistors are labelled RP1 , RP2, and RP3. If 
channel 1 is not at the end of the SCSI cable, REMOVE THESE TERMINATORS from the 
daughter card. 


Fuse 

The daughter card has a 1.5A fuse (F1) (part number LITTELFUSE 273-01.5), used to protect 
the SCSI terminator power when provided by the card. 

USDs on Differeniial Daughter Card 

The Differential Daughter Card has 2 LEDs. Refer to Table 2-23 for a description of the LEDs. 


Table 2-21 Differential Daughter Card LEDs 


DESIGNATOR 

FUNCTION 

DESCRIPTION 

LED1 

TERMPWR 

When illuminated, incficates TERMPWR is OK 

LED2 

SCSI BUSY 

When illuminated, indicates BSY is asserted on 
the SCSI bus. 
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DIFFERENTIAL WIDE DAUGHTER CARD DIFFERENTIAL WIDE DAUGHTER CARD 

5c. Differenti€d Wide 3081-2 Daughter Card 


Jumpers Used On IHfferential Wide SCSI-2 Daughter Card 

If your setup includes a Wide differential daughter card, it may also be necessary to set some 
jumpers on the card. To determine the location of the jumpers, refer to Rgure 2-7, 


Component Side 



Figure 2-7 Differential Wide SCSI-2 Daughter Card 


J11 - Terminator Power to Differential Wide Secondary Bus: 


J11 is used to connect terminator power to the secondary SCSI bus. Placing a jumper in J11 
connects the power. The daughter card is shipped with a jumper installed in J11. 

J12 - SCSI ID of Differential Wide Secondary Bus 


II I ' "I I" ' ll 

112. I • i • I •8|| 

II-^-1-1-IK12 

111* I • I • I -711 

II , I II i I .11 
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DIFFERENTIAL WIDE DAUGHTER CARD DIFFERENTIAL WIDE DAUGHTER CARD 


J12 - SCSI ID of Differential Wide Secondary Bus 


Pins 1-2: (Jumper must be IN. Factory Default Do Not Alter) 

Table 2-22 Secondary SCSI Channel ID (Differential Wide Channel) 


SCSI ID 

PIN# 

3-4 

5-6 

7-8 

0 

0 

0 

0 

1 

0 

0 

F 

2 

O 

F 

0 

3 

O 

F 

F 

4 

F 

0 

0 

5 

F 

0 

F 

6 

F 

F 

0 

*7 

•F 

*F 

*F 


* as Factoty Default 
O « On 
F«Off 


Termination On D^erential Wide SCSr-2 Daughter €kud 

On the Differential Wide Daughter Card, the DIP terminating resistors are labelled RP1-RP3. If 
channel 1 is not at the end of the SCSI cable, REMOVE THESE TERMINATORS from the 
daughter card. 


Fuse 

The daughter card has a 1.5A fuse (FI) (part number LITTELFUSE 273-01.5), used to protect 
the SCSI terminator power when provided by the card. 
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DIFFERENTIAL WIDE DAUGHTER CARD 


LEDs on Differential Wide SCSI-2 Daughter Card 

The Differential Wide Daughter Card has 2 LEDs, as shown in Figure 2-7. For a description of 
the LEDs, refer to Table 2-23. 


Table 2-23 Differential Wide Daughter Card LEDs 
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5<L Centronics/Dataproducts 
Short Line Printer Daughter Card 


Jumpers Used On €)entromcs/Dataproducts Printer Daughter Card 

If your setup includes a Centronics/Dataproducts Short Line daughter card, it may also be 
necessary to set some jumpers on the card. 

COMPONENT SIDE 



Figure 2-8 Centronics/Dataproducts Short Line Printer Daughter Card 


JP1 and JP2 - Printer Type Selection: 

Jumpers JP1 and JP2 are used to select the desired interface - Centronics or Dataproducts 
Short Line Printer. 
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CENTRONICES/DATAPRODUCTS 


The valid settings for JP1 and JP2 are as follows: 

Centronics Printer: JP1: OUT 

JP2: IN 

Dataproducts Short Line Printer: JP1: IN 

JP2: OUT 

Termination On Centronics/Dcitaprodticts Printer Daughter Card 

Be sure to set the termination appropriately for the printer selected using jumpers JP1 and JP2. 

Centronics Printer: RP1 = 470 Ohms 
RP2 = Not Installed 

Dataproducts Short Line Printer: RP1 = 390 Ohms 

RP2 = 390 Ohms 

LEDs an Centronics/Dcitaproducts Printer Daughter Card 


Table 2-24 Centronics/Dataproducts Short Line LEDs 


DESIGNATOR 

FUNCTION 

DESCRIPTION 

LED1 

GOT.LBUS 

When illuminated, indicates the printer daughter 
card is driving the Local Bus. 

LED2 

COMMANDJN_PROGRESS 

When illuminated, indicates the printer daughter 
card is executing commands from the 
motherboard. 
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5e. Diitaproducts Long Line Printer Daughter Cctrd 


Jumpers Used On Dataproducts Lang line Printer Daughter Card 
COMPONENT SIDE 


IT 


IIO 01 
RO oil 

yo oi 
RO oa 
RO oa 
RO oap6 
RO oa 
RO oa 
RO oa 
RO oa 
RO oa 
RO oa 
RO oa 


RO oa 
RO 0| 

RO OB 
RO OB 
RO 0| 

RO oBPS 
RO OB 
RO oa 
RO oa 
RO oa 
RO o| 

RO oa 
RO oa 


L L 

E E 

D D 

2 1 


JHHIJ 

PI JUJlp 


1 2 



111 


J1 


Figure 2-9 Long Line Printer Daughter Card 


JP1 and JP2 - Printer Type Selection: 


JP1 and JP2 are used to select the desired interface. 
Dataproducts Long Line Printer: JP1: IN 

JP2: IN 
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Termination On Dataproducts Long Line Daughter Card 

No termination is required for the Dataproducts Long Line printer daughter card. 

LEDs on Dataproducts Long Line Daughter Card 

Table 2-25 Dataproducts Long Line Daughter Card LEDs 


DESIGNATOR 

FUNCTION 

DESCRIPTION 

LED1 

GOT_LBUS 

When illuminated, indicates the printer daughter 
card is driving the Local Bus. 

LED2 

COMMANDJN_PROGRESS 

When illuminated, indicates the printer daughter 
card is executing commands from the 
motherboard. 
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Step 6. Cabling Procedure 

The cabling procedure depends on which 4220 Cougar 11 motherboard and optional daughter card 
(If installed) you are using. Refer to the Appendix discussion on, Connector Printouts and Cabling 
for details on the required cables. 


CAUTION 


System power and peripheral power must be turned OFF before 
attempting to install the controller. Failure to do so may result 
in severe damage to the board and/or system. 


Once the board is configured, ensure that the host system and peripherals are turned OFF. 






Installation 


CENTRONICS/DATAPRODUCTS 


CENTRONICES/DATAPRODUCTS 


SCSr'2 Cabling Instructions 

Table 2-26 summarizes the various SCSI-2 configurations of the 4220 Cougar 11. 


Table 2-26 SCSI-2 Cable Variations 


To Implement 

Cable the Board as Follows: 

A Single<ended SCSI bus on the primary SCSI channel 

Connect a single-ended SCSI 'A cable* to 
the rrK>therboard's P7 connector. 

A Differential SCSI bus on the primary SCSI channel 

Connect a differential SCSI *A cable* to the 
motherboard’s P7 connector. 

A Single*Ended Wide SCSI bus on the primary SCSI channel 

Connect a single-ended SCSI *P cable* to 
the motherboard's P8 connector. 

A Differential Wide SCSI bus on the primary SCSI channel 

Connect a cfifferential SCSI *P cable* to the 
motherboard’s P8 connector. 

A Single-Ended Wide SCSI bus on the secondary SCSI 
channel card 

Cormect a single-ended SCSI *P cable* to 
the daughter card's Pi 3 connector. 

A Differential Wide SCSI bus on the secondary SCSI channel 

Connect a cfifferentiai SCSI *P cable* to the 
daughter card's PI 3 connector. 

A Single-erKled SCSI bus on the secondary SCSI channel 

Connect a single-ended SCSI *A cable* to 
the dcujghter card's PI 4 connector. 

A Differential SCSI bus on the secondary SCSI channel 
(provided by Fast differential daughter card, if installed) 

Connect a cfifferentiai SCSI *A cable* to the 
dau^ter card's Pi 4 connector. 


For a description of the 'A* cable and *P* cable, refer to the appendioes. 
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Printer CcMing Instructions 

Table 2-27 summarizes printer cabling requirements. 


Table 2-27 Printer Cable Instructbns 


TO IMPLEMENT 

CABUNG INSTRUCTIONS 

A Centronics Printer using the Printer Daughter Card 

Connect a Centronics Printer cable to P9 on the Printer Daughter 
Card. Refer to the Appendices for the cable pinout. 

A Dataproducts Short Lme Printer 

Cormect a Dataproducts Printer cable to P9 on the Printer 

Daughter Card. Refer to the Appendices for the cable pinout. 

A Dataproducts Long Line Printer 

Connect a Dataproducts Printer cable to P9 on the Printer 

Daughter Card. Refer to the Appendices for the cable pinout. 


RS232 Connectors And Cables 

There are two 10 pin connectors (2x5 headers) used as the RS232 port cable connectors. 
These connectors are the semne t^ used for the second serial port I/O Extension-X.2 of PC 
compatible machines. 

The connectors are labeled "SPA" and "SPB" for Serial Port A and Serial Port B respectively. 
Refer to either motherboard layout in the front of this chapter for location. Both RS232 ports on 
the board are configured as Data Terminal Equipment (DTE). 

As an option, a terminal may be connected to SPA to view debug informatbn provided by the 
Cougar 11. See Rrmware Optbns jumper settings, in this chapter, to enable/disable the console 
messages. SPB is used for advanced debug operatbns, with factory assistance. 


Step 7. InstaUing the BtXMrd 


1. Carefully sibe the board into the VMEbus card slot. It should slide all the way in without any 
diffbulty. If it doesn’t, pull it out and check to make sure that there are no cables in the way. 

2. Once the board is properly seated in the sbt, tighten the captive mounting screws on each 
end of the front panel. 

3. Connect the SCSI devbes to the SCSI cable(s). following the directions given by the device 
manufacturers. 
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centronices;dataproducts 


I 


4. Apply power to the system and peripherals. The board OK LED on the Cougar II should 
change from red to green when the power-on self test is complete and the board enters Run 
mode. 
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System Interface 


Overview 

The host communicates with the board through the onboard Short I/O space, mapped into the Short I/O 
space of the VMEbus. The MASCI system-level interface allows the board to reset and initialize the board, 
set up multiple work queues, queue multiple commands internally, read command responses and board 
configuration, and status information. Every location can be physically both written to and read from by 
the host at any time, but the protocol of the MACSI System Interface puts some restrictions upon when 
certain areas should be accessed. Also, some areas are logically write only or read only. 

NOTE 


When issuing commands or otherwise interacting with the board via 
the MACSI Interface, the host must clear all bits and fields marked 
"RESERVED" to 0. For performance reasons, the board does not 
execute a sanity check on all reserved fields. Clearing these 
resen/ed fields helps avoid driver problems that may otherwise 
occur when a later firmware implementation is released. 


MACSI partitions the Short I/O space Into six major sections: 

• Master Control/Status Block (MCSB) 

• Master Command Entry (MCE) 

• Command Queue (CQ) 

• Host Usable Space (HUS) 

• Command Response Block (CRB) 

• Controller Specific Space (CSS) 
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Offset from 
Short I/O 
Base Address 

•fOxO 

to 

+OxF 

+0x10 

to 

+0X1B 

+0x10 

to 

+0x93 

+0x94 

to 

+0X73B 

+0x730 

to 

+0x787 

+0x788 

to 

+0X7FF 


Master Control/Status Block 


Master Command Entry 


Command Queue 


Host Usable Space 


Command Response Block 


Configuration Status Block 


Figure 3-1 Typical Memory Map of 2K Short I/O Space 


MfMSter Cantrol/Status Block pdCSB) 

The Master Control/Status Block (MCSB) is used to exchange information relative to the overall operation 
of the board. The 16-byte MCSB consists of the Master Status Register (MSB), the Master Control 
Register {MCR), the Interrupt on Queue Available Register {\OAR), the Queue Head Pointer {QHP), and 
the Thaw Work Queue Register (TWQR). 
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Table 3-1 Master Control/Status BIcxjk (MCSB) 



Master Status Register (BSSR) 

The board uses this register to report board level status. From the host point of reference, this is a 
READ ONLY register. However, the contents of this register are not valid for 100 microseconds 
following a controller reset. Figure 3-2 shows the bit definition. 


j 15 j 14 I 13 i 12 I 11 i 10 j 9 


j 8 j 


7 I 6 I 5 I 4 I 3 



Controller Not Available 
Board O.K. 


• Reserved 


Figure 3-2 Master Status Register (MSR) 


Bit 0 Controller Not Available (CNA): 

The board sets this bit to 1 to indicate that it is Not Available to receive a command. This 
condition can be caused either by a controller reset or by the execution of controller diagnostics. 
CNA will also be set if a board initialization command fails to complete (see Chapter 5, Initialize 
Controller Command, page ?). The board will clear this bit when it is capable of accepting a 
command. 

Bit 1 Board OK (BOK): 

The board sets this bit to 1 when the power-up diagnostics are completed successfully. A 0 
indicates that the board detected a failure during the power-up diagnostics. The host can start 
polling the Board OK bit 100 microseconds after the board has been powered up or reset, allowing 
approximately 200 milliseconds for normal power-up diagnostics to complete. 
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Table 3-2 Board OK/Controller Not Available Relationship 


BOK 

CNA 

Description 

0 

0 

The controller has failed to operate and is not 
capable of accepting a command. 

0 

1 

Controller is Not Available. If the controller is 
not still executing power-up diagnostics, then 
it has either failed to execute power-up 
correctly or it has failed to complete a board 
initialize command. 

1 

1 

The controller has successfully completed 
power-up diagnostics but it is not capable of 
accepting a command, because it is executing 
the diagnostics command. 

1 

0 

The controller has completed diagnostics and 
is capable of receiving commands. 


Bits 2-15 Reserved (RSRV): 

These bits are reserved and are cleared to 0 by the board. 


Master Control Register CMCR) 


All bits in this register are both set and cleared by the host. From the board’s point of reference, this 
Is a READ ONLY register. The board does not ever set any of these bits. The bits are defined in 
Figure 3-3. 



»Start Queue Mode 
• Reserved 

► Reset Controller 
•SYSFAIL* Enable 

► Reserved 


NOTE: Reserved bits must be cleared to 0 by the host. 


Figure 3-3 Master Control Register (MCR) 
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Bit 0 Start Queue Mode (SQM): 

Once the Command Queue and work queues are initialized, the SQM bit may be set to “1" by the 
host. The only operation performed by the 4220 board in response to the host setting this bit is 
to the Queue Mode Started Bit in the Command Response Status Word (see pages 3-18). The 
SQM bit is supported to provide backward compatibility with the V/SCSI 4210 Jaguar SCSI-1 
controller. 

Bits 1-11 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

Bit 12 Reset Controller (RES): 

The RES bit controls the microprocessor hardware reset line. It also causes a RESET on both 
of the SCSI buses, if the SCSI reset feature is enabled via jumper setting. The RES bit should 
be used only to recover from extreme error conditions. To ensure proper operation, the host 
must leave this bit set for at feast 70 microseconds. 

Bit 13 SYSFAIL* Enable (SFEN): 

The SFEN bit enables the boaid to drive the SYSFAIL* signal on the VMEbus if it detects an 
internal failure during power-up diagnostics or if the firmware enters an unused exception vector. 
If this bit is 0, the board will not drive the SYSFAIL* signal under any circumstances. The board 
initializes this bit to 0 after power-up. 

The board does not read the SYSFAIL* Enable bit until detecting an error in the power-up test. 
After detecting an error, the firmware simply loops on setting the SYSFAIL* line to the level 
specified by the bit (provided that the board is sufficiently functional to have the bit cleared). 

The host should wait until the BQK (Board QK) bit is set in the MSR before enabling this bit.The 
host may turn off SYSFAIL* from the board by clearing this bit. The host may enable SYSFAIL* 
after the board has been released from reset. This operation is performed by firmware, and it is 
possible the board may clear the bit if it is set too soon after power-up. The host should wait until 
the BQK (Board QK) bit is set in the MSR before modifying this bit. 

NOTE: The board drives SYSFAIL* at system reset and immediately clears SYSFAIL* after reset 
if configured to do so via jumper setting. 

Bits 14-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 


Interrupt On Queue AvaU.€ible Register (IQAR) 

Each Command Queue entry only occupies a slot in the Command Queue until it is moved into a work 
queue. Thus, the host will almost always have slots available in the Command Queue for issuing 
commands. In the unlikely event that the Command Queue is full when the host attempts to enter a 
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command, the host must wait until the board transfers a command from the Command Queue to an 
internal work queue before it can enter the next command. 

The host determines that the Command Queue is full by looking at the Go/Busy bit in the next 
available Command Queue entry. The Command Queue is full if the Go/Busy bit of the next available 
Command Queue entry is 1. If the Command Queue becomes full, the host can poll the Go/Busy bit, 
waiting until the next Command Queue entry becomes available. The Interrupt on Queue Available 
Register (IQAR) provides a mechanism to generate an optional interrupt to the host when a entry 
becomes available in the Command Queue. 

The IQAR feature is enabled by setting the Interrupt on Queue Entry Available (IQEA) bit in the 
register. If the Interrupt on Queue Half Empty Enable bit is also set, the board will not interrupt until 
the Command Queue is half empty. Otherwise, the interrupt will occur as soon as the board detects 
one empty entry in the Command Queue. The host should wait until encountering the Queue Full 
condition before setting the IQEA bit. Once the IQEA bit is set, the board generates an interrupt when 
the necessary queue conditions are satisfied. The board then clears the IQEA bit. 

The level and vector for the IQEA interrupt are supplied by the host in the IQAR. When the necessary 
queue conditions are satisfied, the board clears the IQEA bit and sets the Queue Entry Available 
(CQA) bit, and the Command Response Block Valid (CRBV) bit, the Command Response Status Word 
(CRSW) of the CRB. Though the board provides this mechanism for Interrupting the host when space 
becomes available in the Command Queue, it is preferable to set up a large enough Command Queue 
so that the full condition occurs infrequently. The number of entries in the Command Queue is set in 
the CIB (refer to Chapter 5, Initialize Controller Command, page ?). 

Note that the generation of this interrupt is not real time. If the host fills in commands from completion 
interrupts, the queue may already have been filled in by the time the IQAR occurs. Therefore, the host 
must check the Go/Busy bit before issuing another command. 


i 15 i 14 j 13 i 12 « 11 i 10 i 

« II-n ..11 ). 11 H I II , II 


9 8 M 7 J 6 I 5 J 4 B 3 8 2 B 1 11 0 II 

II |i II ii ■■ II a. ii .1II. Jill ,11II 

I >-»lntemipt Vector 

•--Interrupt Level 

-- Reserved 

. - — - - ■ ►Interrupt On Queue Half 

Empty Enable 

--Interrupt On Queue Entry Available 


Figure 3-4 Interrupt On Queue Available Register (IQAR) 


Bits 0-7 Interrupt Vector for the Interrupt on Queue Available (IV): 

The board uses this byte as the interrupt vector when issuing an Interrupt on Queue Available 
interrupt. This byte is set by the host and is not modified by the board. The host must not modify 
this byte after setting the IQEA bit. 
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Bits 8-10 interrupt Level for the Interrupt on Queue Available (IL): 

These three bits determine the interrupt level that the board will use when issuing an Interrupt on 
Queue Available Interrupt. These bits are set by the host and are not modified by the board. The 
host must not modify these bits after setting the IQEA bit. 

Values of 1 through 7 are allowed. An Interrupt level of 0 is allowed only when the IQEA bit is 
cleared. 

Bits 11-13 Reserved (RSRV): 

These bits must be cleared to 0 by the host. 

Bit 14 Interrupt on Queue Half Empty Enable (IQHE): 

This bit is a flag which causes the board to generate the IQEA interrupt when the Command 
Queue becomes half empty (rather than as soon as one entry becomes available). The Interrupt 
on Queue Half Empty Enable (IQHE) bit Is valid only when the IQEA bit is set. The IQHE bit is 
set by the host and is not modified by the board. The host must not modify this bit after it has set 
the IQEA bit. 

Bit 15 Interrupt on Queue Entry Available (IQEA): 

This bit is set by the host to request an IQEA. The interrupt Is generated either when the queue 
is half empty or as soon as one entry is available, depending upon the state of the IQHE bit. The 
board clears this bit prior to generating the IQEA interrupt. After the host sets this bit, requesting 
an Interrupt, it cannot change any of the other bits in the IQAR. 


Queue Head Pointer (QHP) 

The QHP provides a convenient place for the host to store the address of the next available entry In 
the Command Queue. The board will neither read nor write the QHP. 


Thaw Work Queue Register (TWQJR) 

This field Is used to restart a work queue that has been frozen due to a SCSI Pass-Through error or 
a SCSI bus reset when these options are enabled. A queue is thawed by writing the appropriate work 
queue number to the designated bits in the upper byte of the register and then setting the Thaw Work 
Queue bit (TWQ). An extension is defined to the Thaw Work Queue Register that allows work queues 
to be numbered from 1 to 255 for Cougar II Wide. Refer to Chapter 6, Eiror Recovery Tools, page 
6-1, for additional information. 
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Reserved for Cougar II 

Work Queue Number for Cougar II 


Thaw Work Queue 
Reserved 

Work Queue Number for Cougar II 
Wide 


Figure 3-5 Thaw Work Queue Register 


Bit 0 Thaw Work Queue (TWO): 

Setting this bit causes the board to resume execution of commands in the work queue specified 
in the upper byte of this word. The board then clears the TWO bit to acknowledge that the queue 
has been thawed. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bits 8-15 Work Queue Number for Cougar II Wide, 

Bits 8-11 Work Queue Number for Cougar II: 

This field specifies the work queue number to be thawed. Values range from 1 to 14 for Cougar 
II. and 1 to 255 for Cougar II Wide. It Is an error to thaw work queue 0. 

Bits 12-15 Reserved for Cougar ii: 

These bits are reserved for the Cougar 11 and must be cleared to 0 by the host. 


Master Command Entry (MCE^ 

The Master Command Entry (MCE) is an auto-initialized facility through which commands are issued to the 
board before the Command Queue and work queues have been initialized. The single slot of the MCE has 
the same 12-byte format as any on-board Command Queue entry. Space must be reserved in the Host 
Usable Space (HUS) portion for the I/O Parameter Block (lOPB) that is pointed to by the MCE. Typically, 
it will be used only when initializing the Command Queue. It does, however, provide a mechanism to issue 
a command to the board even if the Command Queue and all work queues are full. It provides a way to 
get one command Into the board even when the Command Queue is locked up. 


Command Queue 

The Command Queue (CQ) consists of a user-programmed number of Command Queue entries. The host 
sets the size of the Command Queue when via the initialize Controller command. Each Command Queue 
entry includes all of the information needed for the board to find, execute and respond to the commands 
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contained in the lOPB. The actual size of the Command Queue equals the number of entries times 12 
bytes. The Command Queue must have at least one entry. 

The Command Queue is circular, and it Is up to the host to keep track of the next Command Queue entry 
that It can use. Because the queue is circular, the board infers chronological ordering of commands. Each 
Command Queue entry is busy only until the board can transfer the command to a work queue and then 
free its slot in the Command Queue. 


(kmrnand Queue Entry (€)gEi 

A Command Queue entry Is a 12-byte block containing all of the Information needed for the host to 
find and execute a command. Each CQE Is busy only until the board can transfer the command to 
a work queue and free the entry by clearing the Go/Busy bit. This mechanism allows a relatively small 
Command Queue to handle a large number of commands. 

The purpose of the fields in a CQE will vary depending on whether onboard or offboard lOPBs are 
being used. Figure 3-6 shows the format of the two types of Command Queue entries. 





Chapter 


3 


COMMAND QUEUE ENTRY FOR ONBOARD lOPBs: 



COMMAND QUEUE ENTRY FOR OFFBOARD lOPBs: 


Word # 

15 14 13 12 

11 10 

9 8 

B 

1 

1 

B 

0x0 

QUEUE ENTRY CONTROL REGISTER 

0X1 

RSRV 

TT 

MT 

ADDRESS MODIFIER 

0X2 

HOST ADDRESS (MSW) 

0X3 

HOST ADDRESS (LSW) 

0X4 

lOPB LENGTH 

WORK QUEUE NUMBER 

0X5 

RESERVED 


Figure 3-6 Command Queue Entry Format For Onboard And Offboard lOPBs and MCE 


CQE Word O: Queue Entry ikmtrol Register 

The Queue Entry Control Register (QECR): 

• Kicks off command execution. 

• Acknowledges a command abort sequence. 

• Flags a high priority command. 

• Signals whether a command is located Short I/O or system memory. 
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I 15 n 14 

_II 


II ' l( 


" I I I I ■ " If 


13 n 12 II 11 H 10 II 9 II 8 1 7 II 6 H 5 II 4 II 3 M 2 II 1 II 0 


-»Go/Busy 

-•Abort Acknowledge 
-►High Priority Command 
-•Reserved 
-►Fetch Offboard 
-►Fetch In Progress 
-►Reserved 
-►lOPB Type 
-►Reserved 


Figure 3-7 Queue Entry Control Register (QECR) 


Bit 0 Go/Busy (GO): 

The GO bit is set by the host to initiate action on a CQE. The host must assemble the lOPB in 
the Host Usable Space (HUS) and the CQE in the Command Queue before it sets this bit. When 
the GO bit is set, the board moves the CQE and lOPB into internal menx^ry and clears the GO 
bit, releasing the CQE. 

Bit 1 Abort Acknowledge (AA): 

When a command completes with a SCSI Pass-Through error, all commands in, and destined for, 
that work queue can optionally be aborted. This option is specified when the work queue is 
initialized (see Chapter 5, Initialize Work Queue command). 

The AA bit is used to end the command abort sequence, allowing the host to reissue the 
command that completed with error, and allowing commands that were aborted due to the error. 
The host issues the command that completed with error, after appropriate error recovery, with the 
AA bit set. Subsequent commands should be submitted with the AA bit cleared, and normal 
queue operation will resume until another Pass-Through error occurs. 

Bit 2 High Priority Command (HPC): 

The HPC bit flags a command so that the board places the command at the top of Its work queue. 
If there are other commands In the work queue with the HPC bit set, the new command is queued 
up behind the other HPC. 

Bit 3 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host. 

Bit 4 Fetch Offboard (FOB): 

This bit Is only used In applications Involving offboard lOPBs. if this bit is set, then the 
corresponding lOPB will be fetched from the host memory. The only other bit in the Queue Entry 
Control Register that is valid when the FOB bit is set is the Go/Busy bit (Bit 0). For a discussion 
of offboard lOPBs, refer to Chapter 6. Offboard lOPBs, page 6-17. 
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Bits 5 Fetch in Progress: 

This bit is for internal board use only. 

Bits 6-7 (RSRV) Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bits 8-11 lOPB Type; 

These bits describe the lOPB type. The board supports only type zero lOPBs, so this field should 
be cleared to 0. 

Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 


CQEWonil: 

For onboard lOPBs, CQE Word 1 Is used to store the lOPB Address. For offboard lOPBs, it holds the 
memory type, transfer type, and address modifier used by the board to DMA the offboard lOPB into 
onboard memory. 


lOPB Address* 


I 15 I 14 I 13 I 12 I 11 I 10 I 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 I 1 I 0 I 

I I III I I I I■■■II I n i|„^ ill! II i ii i ii nB |-j 

1 ' * . t * * n 11. I ‘ 

I I I I-^Address Modifier** 

I j I-^Memory Type** 

1 I_—•Transfer Type** 

I-—• Reserved** 

* CQE Word for an Onboard lOPB 
*• CQE Word for an Offboard KDPB 


Figure 3-8 CQE Word for Onboard and Offboard lOPBs 


lOPBAddress 

For an onboard lOPB, CQE Word 1 points to the location of the lOPB in Short I/O. The value is 
specified as an offset from the Short I/O base address. The board transfers the CQE and lOPB 
out of Short I/O when the host sets the Go/Busy bit. 
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Memory Type/Tran^er Type/Address Modifier 


For an offboard lOPB, CQE Word 1 is used to specify the mennory type, transfer type, and 
address modifier used to transfer the lOPB onboard (Figure 3-9). 



I ' I I I a ' "IT " '1^— V ■ n i 

|7|6|5|4|3|2|1|0| 
■ ■ ■ ■ ■ ■ ‘ ‘ 


-> Address Modifier 
►Memory Type 
►Transfer Type 
► Reserved 


Figure 3-9 Memory Type/TransferType/Address Modifier 


CQE Words 2-3: 

For onboard lOPBs, CQE Word 2 is used to store a host-assigned command tag. For offboard lOPBs, 
it holds the physical address of the offboard CQE/IOPB. 


Command Tag 

For onboard lOPBs, Command Queue Entry Words 2-3 may be used to store a host-specified 
command tag. The board does not use or modify this field and returns the Command Tag as part 
of the Command Response. In a typical implementation, the host would use a unique value 
Command Tag for each operation to differentiate one command from another. 


Host Address 

For offboard lOPBs, CQE Words 2-3 are used to store the physical address in host memory of 
the offboard CQE/IOPB. Word 2 stores the most significant word of the address, and Word 3 
stores the least significant word. 


CQE Word 4: Work Queue Number and lOPB Length 

CQE Word 4 consists of a Work Queue Number field and an lOPB Length field. 


II . ■. I I I I ' II '■ ,1 ' ! l ' 'l l" I I I I II .. II II II II " ' ll 

II 15 II 14 II 13 II 12 I 11 H 10 II 9 II 8 II 7 II 6 II 5 II 4 H 3 I 2 I 1 II 0 H 

“ I " " '■ " " » ii ^ I' ^ ■' ■' " " " " ^ ” 

I-,_I i_,_I 

I I_.Work Queue Number 

!__—-► lOPB Length 

Figure 3-10 lOPB Length/Work Queue Number 
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Bits 0-3 Work Queue Number: 

This byte contains the number of the work queue in which to place the command in. Since the 
Cougar il supports 14 work queues, valid entries in this field are 0x0 to OxE. 

Cougar II Wide supports 255 work queues, plus work queue 0, Valid entries are 0x0 to OxFF. 

NOTE: Work Queues other than work queue 0 must be initialized via the Initialize Work Queue 
command before use. If the specified work queue has not been initialized, the command will 
return a Queue Uninitialized error. 

Bits 4-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bits 8-15 lOPB Length: 

The lOPB Length byte specifies the length in words of the lOPB to which the CQE is pointing. 
For onboard lOPBs, writing a 0 to this field indicates that the default length of the lOPB Is being 
used. 

NOTE: This field should only contain a non-zero value if the lOPB involves a user-defined 
SCSI command (Group 6 or 7). Refer to Chapter 5, SCSI Pass-Through lOPB, (page ?) for 
additional information. 


CQE Word 5: Reserved 

CQE Word 5 is reserved for both onboard and offboard lOPBs. This field should be cleared to 0 by 
the host. 


Host Usable Space (HUS) 

The Host Usable Space (HUS), typically used to pass the lOPB portion of a command, is freeform memory 
space accessible to both the host and the controller. No partitioning of the HUS is implied or required by 
the MACSI interface and the manner in which it is used is totally under the control of the host. In some 
multiprocessing applications, the HUS is a convenient place to post semaphores between CPUs. 

The amount of HUS available is determined by three factors: 

1. The size of the Short I/O 

2. The number of Command Queue entries defined when the Command Queue is initialized 

3. The length of the Command Response Block that is defined. 

For example, the default 2K Short I/O space the Command Queue is initialized with ten entries (each 
Command Queue entry is 12 bytes long), and a Command Response Block of 76 bytes is defined, there 
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will be 1704 bytes of HUS available. The Master Control/Status Block, Master Command Entry, and the 
Controller Specific Space always occupy a total of 148 bytes. 

Command Response Block (CRB) 

The Command Response Block (CRB) is used by the board to post command completion status. The 
lOPB and related status information are returned in the CRB. The CRB is also used \o return an error 
status block in the event of a controller interrupt. In addition, if enabled to do so, the board uses the CRB 
to signal a number of special conditions. See Command Response Status Word 3-18 for details. 

The CRB Is made up of the: 

• Command Response Status Word (CRSW) 

• Command Tag 

• Work Queue Number 

• Returned lOPB. 

The offset of the Command Response Block is defined when the controller is initialized using the Initialize 
Controller command (page ?). The length of the Command Response Block can be determined by 
subtracting the Command Response Block offset from the offset of the Controller Specific Space (+0x788). 
However, the length of the Command Response Block must be equal to the largest lOPB defined plus 12 
bytes. 

NOTE: If SCSI Autosense Error Recovery is to be enabled, additional space must be allocated in the CRB 
offset for the sense data. The sense data, if any, vwll be reported in the Returned lOPB of the SCSI 
command that caused the error. See Chapter 6, Autosense Recovery, page ? for more information. 
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Table 3>3 Command Response Block (Sample Memory Map) 



NOTE: The above is the memory map of the Commsmd Response Block (CRB) if the CRB offset has been 
set to 40x750 using the Initialize Controller commancL With this setup, the maximum lOPB 
length is that of a SCSI Pass-Through IOP6 used to issue a 12-byta SCSI command (i.e. maximum 
lOPB length > 44 bytes). 


(Command Response Status Word (CRSW) 

The Command Response Status Word (CRSW) is the first word in the Command Response Block 
(CRB) and describes the nature of the Command Response. It also contains a handshake bit, the 
Command Response Block Valid/Clear Interrupt (CRBV) bit. The CRBV bit synchronizes the command 
interaction of the board and the host. Figure 3-11 shows the definition of the CRSW bits. 
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Bit 0 Command Response Block Valid/Clear Interrupt (CRBV): 

The Command Response Block Valid/Clear Intenupt (CRBV) bit is set by the board after it loads 
the returned lOPB, the Work Queue Number, and the Command Tag into the Command 
Response Block (CRB). It remains set until cleared by the host. 

The CRBV bit is also an Interrupt Pending bit because the board sets it immediately prior to 
issuing a Command Complete Interrupt to the host. The board keeps the CRB stable while this 
bit is set. 

After finishing with the Information In the CRB, the host clears the interrupt by clearing the CRBV 
bit. Once this bit Is cleared, the board can use the CRB to present the next command response. 

Bit 1 Command Complete (CC): 

The Command Complete (CC) bit is set by the board when the CRB contains the response to a 
command Completion, as opposed to a Queue Entry Available or Start Queue Mode started 
condrtion. The CC bit is set even when the command is completed with error or exception. 

Bit 2 Error (ER). 

The Error (ER) bit is set by the board when the CRB contains an lOPB that has completed with 
an error status. Examples of conditions that may cause an lOPB to complete with the Error bit 
set include: 

• An incorrectly specified parameter which causes the board to misinterpret the command 

• An invalid address leading to bus errors or timeouts 

• A faulty device which causes a timeout 

A Pass-Through command that returns any value other than zero in the Pass-Back Return Status. 
The ER bit is valid only when Command Complete is set. 

Bit 3 Exception (EX): 

The Exception (EX) bit is set by the board when the CRB contains an lOPB that has completed 
with an exception. 

A command completed with exception Is one which completed without error, but has some lOPB 
parameter that has not been completely satisfied. 

EXAMPLE: The board completes a Pass-Through SCSI command without transferring all of the 
data specified in the lOPB’s transfer count field (for many SCSI commands, this is not an error 
condition, but rather something about which the host probably needs to be notified). 

The EX bit is valid only when Command Complete is set. 
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Bit 4 Abort Work Queue (AQ): 

When work queues are initialized by the host, they can be set up, optionally, so that all of the 
commands in the queue can be aborted after a SCSI Pass-Through command completes with an 
error (see Initialize Work Queue Command, Chapter 5). The command that completed with an 
error is reported just like any other error, with the ER bh set in the CRSW. 

With the Abort on Error option enabled, all commands following a command that completes with 
a SCSI Pass-Through error will be aborted. All commands in the Command Queue destined for 
that work queue will be aborted until a command with the Abort Acknowledge bit set in the QECR 
is encountered (see Queue Entry Control Register, page 3-10). All of the aborted commands are 
reported in the CRB with the CC, ER, and AWQ bits set. The Error Interrupt Vector of the 
command being aborted will be used to report this condition. 

Bit 5 Queue Mode Started (QMS): 

This bit indicates whether the board is in Queue Mode. The board sets this bit to 1 to indicate 
normal Queued IQPB operation. 

The 4220 supports the Start Queue Mode bit to provide backward compatibility with the V/SCSI 
4210 Jaguar. It is not needed by the Cougar to start executing queued lOPBs. 

Bit 6 Command Queue Entry Available (CQA): 

The Command Queue Entry Available (CQA) bit is set by the board when the CRB is presented 
in response to a Queue Entry Available condition. The CQA bit is mutually exclusive with the CC 
bit. 

Bit 7 Status Change (SC): 

This bit is set to indicate a condition such as: 

• A printer status change has occurred. 

• A device has connected for which no lOPB exists (lOPB type error). 

• An lOPB has timed out. 

• A device is requesting more data to be transferred than the lOPB allows. 

• A device Is requesting a data transfer of the opposite direction specified by the lOPB’s 
direction bit. 

If the SC bit is set, the board will return an error status block without returning the lOPB that 
caused the error. For more information, refer to the sections on the Controller Error Interrupt and 
Vector in Chapter 6. 

Bits 8-9 Reserved (RSRV): 

These bits are reserved and are cleared by the board. 
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Bit 10 SCSI Bus Reset: 

This bit is set to indicate a SCSI Bus Reset has occurred, when the Interrupt on SCSI Bus Reset 
option is enabled. 

Bit 11 SCSI Error (SE): 

This bit is set by the board to report a non-recoverable SCSI error. In this condition, the SCSI 
control hardware on the 4220 should be assumed to be in an unknown (but not desirable) 
condrtion, and will require a SCSI bus reset to return to a functional state. (See Appendix C). 

Bit 12 Queue Frozen: 

This bit is set by the board to indicate that a queue frozen status is being reported. This option 
is enabled via the Initialize Work Queue command. The Command Tag field will be cleared to 
zeros and the Work Queue Number field will contain the number of work queues being frozen. 
The CRSW is extended to provide for post back of queue frozen status. If enabled via the 
Initialize Work Queue command, this option allows the controller to report work queue status for 
the more than 15 work queues. When a command is returned with a SCSI error that causes a 
work queue to freeze, the queue frozen bit will be set in the Command Response Status Word: 

Bit 13 Recovered Error: 

When this bit is set, along with CC and CRBV, the command has completed in a recovered error 
state. The device completed the SCSI command with a check condition, an automatic SCSI 
request sense has been issued, and the resulting sense data has been returned in the CRB. This 
condition will be reported through the Error Completion Vector set in the lOPB for the command. 

Bits 14-15 Reserved (RSRV): 

These bits are reserved and are cleared to 0 by the board. 


Command Tag 

This Command Tag is the same 4-byte value that was provided in the Command Queue Entry when 
this command was originally issued to the board. The board does not use or modify the Command 
Tag. It simply returns the Command Tag as part of the Command Response. The Command Tag 
may be used by the host to determine to which command the board is responding. 


lOPB Length Work Queue Number 

The lower byte of this word specifies the number of the work queue to which the command was issued. 
The upper byte specifies the length of the returned lOPB. A length of zero indicates the lOPB is the 
default length. The entire lOPB LengttVWork Queue Number word is returned from the Command 
Queue entry exactly as it was originally entered by the host. 
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Returned lOPB 

The Returned lOPB field of the Command Response Block is usually an image of the lOPB that was 
passed with the Command Queue Entry when the command was originally issued to the board. 

In some cases, depending upon the specific lOPB, some of the parameters are modified to reflect 
Command Completion status or other information such as the maximum Transfer Length and the SCSI 
sense bytes if SCSI Autosense Error Recovery is enabled (see pages ? and ?). 

The returned lOPB area is undefined for a response to a Queue Entry Available condition or for any 
other command response where the original command did not require an lOPB. 


Controller Specific Spai:e 

The Controller Specific Space is a 120-byte space used by the board to post the Configuration Status Block 
(CSB). The board uses the 120-byte Controller Specific Space to post the Configuration Status Block. This 
space begins at an offset of +0x788 from the Short I/O base address (default Short I/O size of 2K bytes). 
Figure 3-12 shows a typical 2K Short I/O memory map. 

Offset from 
Short I/O 
Base Address 


•fOxO 

to 

+0xF 


+0x10 

to 

+0x1 B 


+0x10 

to 

+0x93 


+0x94 

to 

+0X73B 


+0X73C 

to 

+0x787 


+0x788 

to 

+0X7FF 


Master Controi/Status Block 


Master Command Entry 


Command Queue 


Host Usable Space 


Command Re^onse Block 


Configuration Status Block 


Figure 3-12 Typical Memory Map of 2K Short I/O Space 
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Cartfiguratian Status Block ((2SB) 

The board uses the CSB to report Its current configuration. This includes such information as the 
product code, firmware revision information, memory configuration, SCSI ID, jumper settings, SCSI 
synchronous negotiation rate, and Frozen Work Queues. CSS begins 120 bytes before the end of the 
Short I/O. The CSB values are valid after completion of a controller rest. The format of the CSB is 
shown in Figure 3-13. 
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OFFSET 


15 I 14 


13 12 11 10 I 9 8 


6 5 



+0X79A 

To 

+0X7A1 



■c0x7BA 


3 2 1 


EXTENDED BOARD ID 


RESERVED 


RESERVED 


BOARD IDENTIFICATION 


PRODUCT CODE 


RESERVED 


RESERVED 


PRODUCT CODE 


VARIATION 


FIRMWARE REVISION LEVEL 


FIRMWARE REVISION LEVEL 


RESERVED 


FIRMWARE RELEASE DATE 


SIZE OF CPU RAM 


SIZE OF DATA BUFFER 


AVAILABLE WORK QUEUES 


PRIMARY FRONT END CHANNEL ID 


PRIMARY SCSI BUS ID 


LAST PRIMARY DEVICE SELECTED 


PRIMARY PHASE SENSE 


RESERVED 


RESERVED 


PRIMARY DEVICE SYNC. 
NEGOTIATION RATE 


SECONDARY FRONT END CHANNEL ID 


SECONDARY SCSI BUS ID 


LAST SECONDARY DEVICE SELECTED 


SEC. PHASE SENSE/PRINT STATUS 


DAUGHTER CARD ID 


SOFTWARE JUMPER SETTINGS 


SECONDARY DEVICE SYNC. 
NEGOTIATION RATE 


FROZEN WORK QUEUES REGISTERS 


RESERVED 


RESERVED 


RESERVED 


* EDCID « Extended Daughter Card ID 


Figure 3-13 Configuration Status Block 
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A description of the values found in the Configuration Status Block follows: 

Board Identification (2 bytes): 

The contents of this field is the value 0x4220, indicating to the host the presence of a Cougar II. 

Extended Board ID (1 byte): 

The hex code contents of this field indicate the revision control for board identification. 0x0 
identifies the board as a Cougar I. 0x1 is resen/ed, and 0x2 identifies the board as a Cougar II. 

Product Code (3 bytes): 

The Interphase product code. This value is represented as a 3-character ASCII string. The most 
significant character appears first. 

Product Variation (1 byte): 

The interphase product variation code. This value is represented as one ASCII character. 
Firmware Revision Level (3 bytes): 

The revision level of the installed firmware. This value Is represented as a 3-character ASCII 
string. The most significant character appears first. 

Firmware Release Date (8 bytes): 

The release date of the installed firmware. This value is represented as an 8-character ASCII 
string in the format, MMDDYYYY. A January 15,1995 release date would be 01151995. 

Size of CPU RAM (2 bytes): 

The amount of on-board CPU RAM expressed In 1K increments. This value is represented as a 
four-digit hexadecimal number. 

Size of Data Buffer (2 bytes): 

The amount of on-board data buffer RAM expressed in 1K increments. This value Is represented 
as a four-digit hexadecimal number. For example, a 128K RAM data buffer would be 0x0080. 

Available Work Queues: 

The number of work queues available. With less than 256K of RAM the maximum 
number of work queues is 15. With 256K, or greater, of RAM the maximum number of 
work queues is 256. The only values reported are either OxF or OxFF. 

Primary Front End Channel ID (1 byte): 

The type of primary front end channel. Table 3-4 lists the possible values. 
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Table 3-4 Front End Channel Types Returned in the CSB 


ID Number 

Front End Channel Type 

0x0 

Single-ended Cougar II 

0x1 

Differential Cougar II 

0x2 

Single-ended Cougar II Wide 

0x3 

Differential Cougar II Wide 

0x7 

Printer 

OxE 

Differential Cougar II with 

RAID memory** 


This option requires customer-specific proprietary 
hardware 


Secondary Front End Channel ID (1 byte): 

This 1-byte hexadecimal value represents the secondary front-end channel type. Values are 
shown in Table 3-4. 

Primary SCSI Bus ID (1 byte): 

The current SCSI ID for the primary SCSI bus. This value Is represented as a 1 -byte hexadecimal 
number. This value will default to the SCSI ID encoded in the on-board switches at the 
completion of a reset. This value will be updated at the completion of an Initialize Controller 
command. 

Secondary SCSI Bus ID (1 byte): 

This 1-byte hexadecimal value is the current SCSI ID for the secondary SCSI bus. It defaults to 
the SCSI ID encoded in the jumpers on the SCSI daughter card at the completion of an Initialize 
Controller command. 


Last Primary Device Selected (1 byte): 

Contains the SCSI ID of the last primary SCSI bus device selected by the board. This field is 
updated every time the board selects or Is reselected by a device on Channel 0. 

Last Secondary Device Selected (1 byte): 

Contains the SCSI ID of the last secondary bus device selected by the board. This field is 
updated every time the board selects or is reselected by a device on Channel .1. 
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Primary Phase Sense (1 byte): 

Contains the status of the primary SCSI bus. The primary phase sense register contains a copy 
of the phase sense register of the SCSI controller chip. This copy is updated on every SCSI 
interrupt. The signals in the register are shown in Figure 3-14. 


D7 i D6 I 05 i D4 i 03 I 02 H D1 i DO 

I " I ■' . " . . " 


I I 
I I 


Input/Output 

Control/Data 

Message 

Attention 

Select 


Busy 

Acknowledge 

Request 


Figure 3-14 SCSI Bus Status Byte 


Each of the above bits corresponds to a signal on the SCSI bus. If the bit is set, the 
corresponding SCSI signal is active. Table 3-5 shows the meaning of the signals. 


Table 3-5 Meaning of SCSI Signals in the Phase Sense Byte 


SIGNAL 

NAME 

DESCRIPTION 

REQ 

Request 

The target asserts REQ to start an asynchronous bus transfer. 

ACK 

Acknowledge 

The initiator asserts ACK to indcate that it has sent (or received) data. 

This signal is used in tandem with REQ to handle all asynchronous data 
transfers. 

BSY 

Busy 

This signal is driven by the initiator or target using the bus to indicate that 
the bus is busy. 

SEL 

Select 

The initiator assarts SEL to indicate which target is to perform an 
upcoming operation. The ID of the target is simultaneously sent over the 
data lines. The target assarts SEL to reconnect during the Reselection 
phase. 

ATN 

Attention 

The initiator asserts ATN to tell the target that there is a message waiting 
for it 

MSG 

Message 

The target drives this signal when it is transferring a message (as opposed 
to data). 

C/D 

Control/Oata 

The target uses this signal to indicate the type of information on the bus 
(asserted « command/message, negated « data). 

I/O 

Input/Output 

The target drives this signal to control the direction in which data is moving 
on the bus (assorted = taiget-to-initiator transfer, negated = initiator-to- 
target transfer). 
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For a complete description of the signals, please refer to the SCSI specification. 

Secondary Phase Sense/Printer Status (1 byte): 

If the board has a SCSI daughter card, this byte shows the status of the secondary SCSI bus and 
the format is the same as for the SCSI Bus Status Byte in Rgure 3-14 If using a printer daughter 
card, this byte shows the status of the printer, and this register contains the printer status. This 
register will be updated at the completion of any print command or approximately every 27 to 
35msec. The bit definition of this register is dependent on whether the interface is Dataproducts 
or Centronics type. The format of this register may be seen in Figure 3-15. 


Dataproducts Printer Status: 


II ' t r ■■ I I II ' " — 11. . It II II II 

11 D7 H D6 H os H 04 n H D2 n D1 n DO H 

■■ “ ■' “ •- '< " " 


1 

1 

1 

1 

1 

1 

1 

1 

1 i 1 

1 1 1 

! ! ! 

1 t- 

1 1 1—»Ready 

1 > -^Online 

< -►Parity Error 
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Figure 3-15 Printer Status Register 


Extended Daughter Card ID (3 bits): 

The Extended Daughter Card ID field may provide additional information about the optional 
daughter card. The values that appear in this field are shown in Table 3-6. 
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Table 3-6 Extended Daughter Card ID 


CODE 

DESCRIPTION 

0x0 

No Daughter Card Present, or Unknown 

Daughter Card 

0x1 

Single-Ended Daughter Card 

0x2 

Differential Daughter Card 

0x3 


to 

RESERVED 

0x7 



Daughter Card ID (1 byte): 

The Daughter Card ID field indicates the type of optional daughter board installed. The meaning 
of the codes is shown in Table 3-7. 

Table 3-7 Daughter Card ID 


CODE 

DESCRIPTION 

0x7 

No Daughter Card 

0x6 

SCSI Daughter Card 

0x5 

Resenred 

0x4 

Printer Daughter Card 

0X3 

to 

Reserved 

0x0 



Software Jumper Settings (1 byte): 

Reports the status of options enabled via jumper settings. The configurations reported in this field 
are shown in Figure 3-16. 
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Primary Device Synchronous Rate (1 Byte): 

Provides synchronous negotiation rate in the CSS and a convenient way to determine the 
negotiated synchronous transfer rate for arbitrary SCSI devices. This field has the structure 
shown in Figure 3-17. 


r 

IL 


IS R 14 II 13 « 12 II 11 B 10 II 9 II 8 II 7 


6 II 


4 B 3 


1 B 0 



Secondary Device Sync. 
Negotiation Rate 
Primary Device Sync. 
Negotiation Rate 


Figure 3-17 Synchronous Negotiation Rate 


This value represents the request-request period, but is divided by four (as per SCSI 
specifications) to fit in a single byte. The board supports the values shown in Table 3-8. 

Table 3-8 SCSI Device Synchronous Negotiation Rates 


CONTENTS OF TRANSFER 
PERKDO FIELD 

REQUEST-REQUEST PERIOO 
(Value X 4 NANOSEC = Request Period) 

SYNCHRONOUS RATE 
(MBytes/Seconds) 

HEX 

DEC 



00 

00 

N/A 

Asynchforwus 

19 

25 

100 

10.0 

1e 

30 

120 

8.3 

23 

35 

140 

7.1 

28 

40 

160 

6.3 

2d 

45 

180 

5.6 

32 

50 

200 

5.0 

37 

55 

220 

4.5 

3a 

60 

240 

4.2 

46 

70 

280 

3.6 

so 

80 

320 

3.1 

5a 

90 

330 

2.8 

64 

100 

400 

2.5 

6e 

110 

440 

2.3 
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Frozen Work Queues: 

This register provides Frozen Work Queue status for work queues 1-15 (Figure 3-18). Work 
Queues 16-255 are reported only through the CRSW (bit 12 Queue Frozen). Work Queues 
16-255 will only be reported in the CRSW provided the option is enabled via the Initialize Work 
Queue command. 
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—WORK QUEUE 1 
—WORK QUEUE 2 
—WORK QUEUE 3 
—WORK QUEUE 4 
—WORK QUEUE 5 
—►WORK QUEUE 6 
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—WORK QUEUE 8 
—WORK QUEUE 9 
—WORK QUEUE 10 
—►WORK QUEUE 11 
—►WORK QUEUE 12 
—►WORK QUEUE 13 
—WORK QUEUE 14 
—►WORK QUEUE 15 


Figure 3-18 Frozen Work Queues Register (Work Queues 1-15) 
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Issuing Commands to the Controller 

The board supports two distinct types of lOPBs: 

1. SCSI lOPBs; Commands sent to either the attached SCSI devices or to the printer port (if used) 
and issued through the Command Queue to a specific work queue. 

2. Control lOPBs: Commands for the board itself, such as initialization commands, that result in 
local board action only. In general, control lOPBs are Issued through the Master Command Entry 
to Work Queue 0. 

Both the Master Command Entry and Command Queue entry are 12-byte blocks with the same format. 
The Go/Busy bit Is a semaphore reflecting ownership of the Command Queue entry. Once the host sets 
the Go/Busy bit, the board owns the entry. The host must not modify the entry until the board clears the 
Go/Busy bit. The board clears the bit to indicate that the space is available to accept another command 
from the host. 

Commands issued through the Master Command Entry (MCE) have precedence over those issued through 
the Command Queue. In general, the MCE is used to get the board up and running. The Command 
Queue is then used to handle the SCSI bus and, if the optional printer port is installed, printer operations, 
it should not be necessary to use the MCE again until there is a "break" in normal operations, such as a 
SCSI device error. 


Notes On The Master Command Eintry & Work Queue O 

In order to initialize the board, as well as to execute high priority commands, the board provides two auto- 
initialized facilities: the Master Command Entry (MCE) and Work Queue 0. 

The MCE, a 12-byte structure, has exactly the same form as a Command Queue entry (I.e. control 
information and a pointer to an lOPB). It acts like a single-entry Command Queue. 

The Cougar II accommodates up to 14 work queues and the Cougar II Wide up to 255 work queues. This 
is not counting a special queue called Work Queue 0. Work queue 0 Is intended for issuing special 
commands such as initialize controller or error recovery, etc. Cougar II Wide supports up to 255 work 
queues, numbered 0 through 255. Work queues are Intended to be dedicated to a specific SCSI-2 device. 
Multiple work queues may be dedicated to the same device. The host sets the paramenters of each work 
queue when It initializes the queue. 

Work Queue 0 is the highest priority work queue, so any command sent to Work Queue 0 Is executed 
immediately. Work Queue has a length of 1, so that only one high priority process can occurat a time. 
However, it is possible that a command from Work Queue 0 may require error recovery. To deal with this 
situation, certain commands (specifically, SCSI Bus Reset and Flush Work Queue) may always be Issued 
through Work Queue 0. For all other commands. Work Queue 0 has a length of 1. 

The MCE and Work Queue 0 allow the issuing of a single command then waiting for Its completion before 
issuing the next one. A typical use for these facilities is, upon power-up, to initialize the rest of the work 
queues and begin normal SCSI operation. 


3-31 









Chapter 



Note that the MCE and Work Queue 0 rernain available for use even after the Command Queue and the 
other work queues are initialized and normal activity has begun, so that error recovery command may be 
Issued through this mechanism. 


Issuing A Command Via The Master Command Entry 

The following is a summary of the sequence of events that need to take place in order to issue commands 
through the MCE: 

• The host builds an lOPB for the command in Host Usable Space. 

• The host fills in the Master Command Entry. 

• The board copies command-related information from the lOPB into Work Queue 0. 

• The board executes the command. 

• The board writes the lOPB and command completion information to the Command Response 
Block. This returned iOPB contains command completion status, as well as information to enable 
the host to identify which command has completed. 

• The board posts completion to the host by setting the Command Response Block Valid bit (bit 0) 
in the Command Response Status Word in the Command Response Block and optionally 
generating an interrupt. 

• The host acknowledges the command’s completion by clearing the Command Response Status 
Word. This frees the Command Response Block to receive information concerning the next 
completed command. 


Notes On The Command Queue 

The Command Queue is circular, and it is up to the host to keep track of the next Command Queue entry 
it can use. Because the queue is circular, the board infers chronological ordering of commands. Each 
Command Queue entry is "busy" only until the board can transfer the command to a work queue and free 
its slot in the Command Queue. 

In the unlikely case that the Command Queue is full when the host tries to enter a command, the board 
provides an option to the host when an entry Command Queue becomes available (refer to Interrupt on 
Queue Available Register, page 3-5). 


Issuing CommtMnds Through The Command Queue 

The standard procedure for issuing commands through the Command Queue is to write Command 
Queue entries and their corresponding lOPBs into the on-board shared memory space. 

The host builds an IOPB for the desired command in Host Usable Space and then creates an entry 
in the next available slot in the Command Queue. 
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When the host sets the Go/Busy bit in the QECR. an internal interrupt is generated to notify the board 
that the CQE is ready to be processed. The board also watches for the next available command by 
polling the CQE pointed to by the current Command Queue pointer. 

The board copies the CQE and its corresponding lOPB into the appropriate internal work queue and 
clears the Go/Busy bit, freeing up that slot in the Command Queue for reuse by the host. 

Commands issued through the Command Queue are executed in the same order issued, unless 
designated as high priority. 

The board writes the Returned lOPB and command response into the CRB. The Returned lOPB 
contains command completion status, as well as information to enable the host to identify which 
command has completed. The board posts completion to the host by setting the CRBV bit in the 
CRSW of the CRB and optionally generating an interrupt. 

The host acknowledges the command completion by clearing the CRBV Bit in the CRSW. This frees 
up the CRB to receive Information concerning the next completed command. 


Notes On Work Queue Usage 

Work Queue 0 has a length of 1, so that only one error recovery process can occur at a time. 
However, it Is possible that a command from Work Queue 0 may require error recovery. To deal with 
this situation, certain commands (specifically, SCSI Bus Reset and Rush Work Queue) may always 
be issued through Work Queue 0. For all other commands. Work Queue 0 has a length of 1. 


SCSI Data Tranters 

The SCSI Pass-Through command is used to issue all SCSI device commands except SCSI Reset. When 
the host builds an lOPB for the command, it provides all of the information the board needs to send a 
command to a specific SCSI peripheral. 

The size of the SCSI Pass-Through lOPB can be adjusted to accommodate different SCSI command 
lengths. For example, to Issue a 12-byte SCSI command, append the 12-byte SCSI Command Descriptor 
Block starting at word 0x10 of the lOPB. 

To determine the length of the SCSI command, the board examines the Group Code field in Byte 0 of the 
Command Descriptor Block (CDB). Table 3-9 shows the possible entries In this field: 
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Table 3-9 Group Codes For SCSI Commands 


GROUP 

CDB LENGTH 

0 

6 bytes 

1 

10 bytes 

2 

10 bytes 

3 

(reseived) 

4 

(reserved) 

5 

12 bytes 

6 

User defined 

7 

User defined 


the command is a Group 0,1,2, or 5 SCSI command, the board will "know" the length of the Command 
escriptor Block (6, 10, or 12 bytes, respectively) and the board will ignore the lOPB Length field of the 
3rresponding Command Queue entry. 

or iCler-defined SCSI command (Group 6 or 7), the host must fill in the lOPB Length field of the 
srresponding Command Queue entry with the number of words in the lOPB. The board then calculates 
\e CDB length by subtracting the overhead of the lOPB (0x10 words) from the length specified in the 
ommand Queue entry (refer to Chapter 5, page 5-3 for details on the SCSI Pass-Through command). 
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VMEbus Interrupts 


At the completion of a command (successful, terminated with an error, or an exception), the board notifies 
the host by generating a Command Complete interrupt on the VMEbus. The board can respond to the 
VMEbus Interrupt Acknowledge Cycle with different interrupt vectors based on the cause of the Interrupt. 
But for those VMEbus systems that allow only one interrupt vector per device, the host can still determine 
the source of the interrupt by checking the status bits in the Command Response Status Word and the 
Work Queue Number found in the Command Response Block. 

The hardware driving the VMEbus interrupt line is cleared at the completion of the VMEbus Interrupt 
Acknowledge Cycle. However, a Clear Interrupt operation must also be executed by the host to notify the 
board that the interrupt has been properly serviced by the host and that the board may now post its next 
interrupt. The host does this by clearing the Command Response Block Valid/Clear Interrupt (CRBV) bit 
in the Command Response Block (see the CRBV bit in Chapter 3 for more information). 

NOTE 


Any information that the host needs from the Command Response 
Block must be accessed before it clears the CRBV bit In the 
Command Response Status Word. 
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Command Set 


Overview 

Commands are issued to the controller using I/O Parameter Blocks (lOPBs). These fall into two basic 
groups: SCSI lOPBs, which are commands that are sent to the attached SCSI devices, and Control lOPBs, 
which result in local controller action only. 

Table 5-1 V/SCSI-2 4220 Cougar II Command Set 


SCSI lOPBs 

COMMAND CODE 

PAGE 

SCSI Pass-Through 

0x20 

5-3 

SCSI Reset 

0x22 

5-15 

CONTROL lOPBs 

COMMAND CODE 


Printer Port 

0x23 

5-19 

Perform Diagnostics 

0X40 

5-27 

Initialize Controller 

0x41 

5-30 

Initialize Work Queue 

0x42 

5-50 

Dump Initialization Parameters 

0x43 

5-57 

Dump Work Queue Parameters 

0x44 

5-63 

Bus Status Inquiry 

0x45 

5-67 

Command Status Inquiry 

0X46 

5-72 

Read/Write Buffer 

0x47 

5-77 

Cancel Command Tag 

0x48 

5-84 

Flush Work Queue 

0x49 

5-88 

Initialize Printer Port 

0X4A 

5-93 

Restart Controller 

0X4B 

5-98 

Device Reinitialize 

0x4C 

5-101 

Issue Bus Device Reset Message 

0x4D 

5-106 

Issue Abort Message 

0x4E 

5-112 

Download Firmware 

0x4F 

5-118 

Set Serial Number 

0x52 

5-128 

Buffer FIFO 

0x53 

5-133 
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In general, SCSI lOPBs are issued to a specific device via its assigned work queue. Each work queue 
must be sep)aratety initialized before commands can be issued to H. Control lOPBs must be issued 
through the Master Command Entry to Work Queue 0. The SCSI Reset command can be issued to either 
a specific device or through the Master Command Entry. Refer to the individual command descriptions for 
details. 

Commands are listed sequentially for easy reference. 

NOTE 


When Issuing commands or otherwise interacting with the board via 
the MACS I interface, the host must clear all bits and fields marked 
"RESERVED" to 0. For performance reasons, the board does not 
execute a sanity check on ail reserved fields. Clearing these 
resen/ed fields helps avoid driver problems that may othenwise 
occur when a later firmware implementation is released. 










(Command Set 


SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


The SCSI Pass-Through lOPB provides all of the information the board needs to send a command to a 
specific SCSI peripheral on either of the SCSI buses. 


Word# 

15 14 j 13 12 

11 10 

9 8 

7 6 5 4 3 2 1 0 

0x0 

COMMAND CODE (0x20) 

0x1 

COMMAND OPTIONS 

0x2 

RETURN STATUS 

0x3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

0x5 

INTERRUPT LEVEL 

0x6 

RESERVED 

0x7 

RESERVED 

TT 

MT 

ADDRESS MODIFIER 

0x8 

BUFFER ADDRESS 
(Or Scatter/Gather List Address) 

0x9 

OxA 

MAXIMUM TRANSFER LENGTH 
(Or Scatter/Gather Elemem Count) 

MAXIMUM TRANSFER LENGTH 

OxB 

OxC 

RESERVED 

(Or Scatter/Gather Total Transfer length) 

0x0 

OxE 

RESERVED 

OxF 

UNIT ADDRESS 

0x10 

SCSI BYTE 0 
(or Seme Data Byte 0) 

SCSI BYTE 1 
(or Seme Data Byte 1) 

0x11 

SCSI BYTE 2 
(or Seme Data Byte 2) 

SCSI BYTE 3 
(or Seme Data Byte 3) 

0X12 

SCSI BYTE 4 
(or Seme Data Byte 4) 

SCSI BYTE 5 
(or Seme Data Byte S) 

0x13 

SCSI BYTE 6 
(or Seme Data Byte 6) 

SCSI BYTE 7 
(or Seme Data Byte 7) 

0x14 

SCSI BYTE 8 
(or Seme Data Byte 8) 

SCSI BYTE 9 
(or Seme Data Byte 9) 

0x15 

SCSI BYTE 10 
(or Seme Data Byte 10) 

SCSI BYTE 11 
(or Seme Data Byte 11) 

0x16 

0x8f 

(Additional Sense Data Bytes, if configured) 


NOTES; Fields set in bold letters are returned values. All other values are host provided. Reserved tields must be cleared to 0 by the 
host. 


Figure 5-1 SCSI Pass-Through lOPB For 12-Byte SCSI Command 
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5 -- 

SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


The remainder of this section describes the function of each field in the SCSI Pass-Through lOPB. 


Host-Provided lOPB Fields 


The following information must be provided in the lOPB for the SCSI Pass-Through command: 


Commaitd Code (2 Bytes) 


This field must be set to 0x20 to execute the SCSI Pass-Through command. 


Comm€Mnd Options (2 Bytes) 


W This field contains the options for this command. The bits are defined as follows: 


— i r - ' T IT ' " II ■' r ■■■ » M 

« 15 II u I 13 I 12 I 11 I 10 I 9 I 8 I 7 I 6 I 
Iti—I, JL II_ JUi .n Iiii.niiill 1,1111 II ly.iiH 



■'■■r' . i r " '- H" — I I 

5 B 4 I 3 I 2 I 1 I 0 I 
Jl.Jill I—*' "T—* 

I-,-1 I I l-*interrupt enable 

( I I -►SCATTER/GATHER 

I I--^SUPPRESS SYNCHRONOUS TRANSFERS 

I-►RESERVED 

-►SUPPRESS lOPB TIMEOUT 

-►RESERVED 

-►TRANSFER DIRECTION 

-►RESERVED 

-►ENABLE WIDE DATA TRANSFERS 

-►SCSI QUEUE TAG TYPE 


Command Options For SCSI Pass-Through Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bit 1 Scatter/Gather: 

This bit should only be set if the command involves a scatter/gather operation. When scatter/gather 
is enabled, the following fields are defined differently than for non-scatter/gather: Address 
Modifier/Memory Type/Transfer Type, Buffer Address, Maximum Transfer Length, and the Reserved 
field at Words OxC - OxD. For a detailed discussion, please refer to Scatter/Gather Operations in 
Chapter 6. 
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SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


Bit 2 Suppress Synchronous Transfers: 

Setting this bit in the first pass-through command sent to a device causes the board to disable 
synchronous transfers with that device. The first command issued to the board without this bit set will 
cause synchronous negotiation at selection. This bit is provided as a work around in the event a 
device does not process the SCSI synchronous data transfer request message correctly. Thus, the 
bit should be cleared for normal operations. 

Bits 3-5 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 6 Suppress lOPB Timeout: 

Setting this bit prevents a timeout from being generated by this lOPB, regardless of the value entered 
for the Command Timeout field in the Initialize Work Queue lOPB during initialization. This allows 
SCSI commands which exceed a normally useful timeout threshold, like Format Unit, to be issued 
through the normal device work queue. 

Bit 7 Reserved: 

This bit is reserved and must be cleared to 0 by the host. 

Bit 8 VMEbus Transfer Direction: 

This bit specifies the direction of the data transfer over the VMEbus, as follows: 


BITS 

VMEbus DIRECTION 

0 

Write data to the VMEbus 

1 

Read data from the VMEbus 


VMEbus Transfer Direction For SCSI Pass-Through Command 


Bits 9-10 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 11 Enabie Wide Data Transfers: 

Setting this bit will cause the board to attempt communication with the device in wide (16-bit) SCSI 
data transfer mode. The first command issued to the board with this bit set will initiate Wide SCSI 
negotiation at selection. Once Wide SCSI data transfers are negotiated, the only way to switch back 
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SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID; 0x20 Command ID: 0x20 


to 8-bit SCSI transfers will be to reset the SCSI bus. This bit is provided as a work around in the 
event a device does not process the SCSI wide data transfer request message correctly, and should 
be set for normal operations. 

Bit 12-15 SCSI Queue Tag Type: 

Refer to the SCSi-2 specification for detailed information on SCSI queue tags. 

The host should determine, through the SCSI Inquiry Command, if a device supports queue tag 
messages prior to issuing a Pass-Through lOPB with a SCSI Queue Tag Type specified. Support for 
SCSI Queue Tag Messages must be handled by the host, since knowledge of the device type is 
required to select an appropriate Queue Tag type. 


Bit 15 

Bit 14 

Bit 13 

Bit 12 

Meaning* 

0 

0 

0 

0 

No Queue Tag Message sent to Target 

0 

0 

0 

1 

Simple Queue Tag Message sent to Target 

0 

0 

1 

0 

Ordered Queue Tag Message sent to Target 

0 

0 

1 

1 

Head of Queue Tag Message sent to Target 


* All bit combinations not listed above are reserved 


SCSI Queue Tag Types 


N(jrm€Ml Completion VectarlError Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


j 15 ii 14 i 13 i 12 i 11J 10 i 9 i 8 I 7 i 6! 51 4 I 3 i 2 i 1 i 0 ii 

I » H " .. . , " *' " " '' " " r " 

I-,-1 I-,-1 

I _►ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 

Normal/Error Completion Vector For SCSI Pass-Through Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 
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SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


i 15 i 14 i 13 i 12 II 11 II 10 i 9 i 8 ii 7 i 6 i 5 i 4 i 3 i 2 il 1 li 0 li 

" ^ .. ' ■' " " . " , " , ” " , " 


INTERRUPT LEVEL 
RESERVED 


Interrupt Level For SCSI Pass-Through Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete Interrupt on the 
VMEbus. Values of 0 through 7 are allowed with a level of 0 allowed only when interrupts are 
disabled by clearing the Interrupt enable bit In the Command Options word. 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


VME Tranter Type (2 Bytes) 

This field specifies the address modifier, memory type, and transfer type to be used for all VMEbus 
transfers associated with the command. 

NOTE: As a slave, the board responds to either 0x2D and 0x29. or 0x2D VME address modifiers 
only. This depends on how the address modifier jumpers are set onboard. For a 
description of these jumpers, refer to chapter 2. As a master, the board will use whatever 
address modifier is in the lOPB. It is not checked. Some memory systems may not support 
all of the options discussed for this field. 
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SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


I 15 ii 14 li 13 i 12 i 11 i 10 i 9 ii 8 11 7 i 6 j 5 i 4 i 3 i 2 J 1 

I. ■■ :i II ■ ii _u ■_ii ■ Jl_ II .11-II- 


0 |j 
_ 11 


ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 
LINK 


VME Transfer Types For SCSI Pass-Through Command 


Bits 0-7 Address Modifier: 


This byte specifies the address modifier used by the board for ail VMEbus data transfers associated 
with this command. 


Bits 8-9 Memory Type: 


This 2-bit field specifies the width of the data transfers. Permitted values are shown below. 


BITS 

BITS 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

16*bit transfers 

1 

0 

32-bit transfers 

1 

1 

Scatter/gather list resides in short I/O* 


* Valid only for Scatter/Gather operations 
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SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


Bits 10-11 Transfer Type: 

This 2-bit field specifies the type of data transfer to be performed. Permitted values are shown below. 


BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL TYPE 

0 

1 

BLOCK MODE 

1 

0 

(RESERVED) 

1 

1 

VME D64 BLOCK 


Bits 12-14 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 15 Link: 

This bit should only be set if you are linking scatter/gather lists. Refer to Scatter/Gather List Linking 
in Chapter 6 for details. 


Buffer Address (4 Bytes) 

This field specifies the address at which the board will begin the data transfer. If the board is 
addressing system memory, the value in the field is a VMEbus address. If scatter/gather is enabled, 
this field Is the address of the scatter/gather list. If the scatter/gather list Is in Short I/O. the value is 
an offset from the board’s Short I/O base address. 



Buffer Address For SCSI Pass-Through Command 
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SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


Maximum Tranter Length (4 Bytes) 

This field specifies the maximum number of bytes that may be transferred by the command. If no 
data is to be transferred, a Transfer Length of zero should be specified. When scatter/gather is 
enabled, this field contains the number of scatter/gather elements. 

NOTE: In the returned lOPB of the the command response, this value reflects the actual number 
of bytes transferred. 


15 


13 

12 


to 

9 


B 


ri 


m 

2 

1 

■ 

MSW 

LSW 

MAXIMUM TRANSFER LENGTH 
(or Scattar/Gathar Element Count) 


Maximum Transfer Length For SCSI Pass-Through Command 


Reserved (4 Byte^ 

Unless scatter/gather Is enabled, words OxC and OxD of the SCSI Pass-Through lOPB are resen/ed 
and must be cleared by the host. For scatter/gather operations, this field specifies the sum of the 
individual element entry counts. See Chapter 6, Scatter/Gather Operations, for details. 


Unit Address Far 5081-2 Opertidan (2 Bytes) 

This field specifies the SCSI bus and the address of the target device for the Cougar II. (For Cougar 
II Wide operation, see Extended Unit Address, page 5-11.) 
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RESERVED 


Unit Address For SCSI Pass-Through Command 
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Command Set 


SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


Bits 0-2 SCSI Device ID: 

These bits contain the SCSI Device ID used when addressing the target. This value may range from 
Oto 7. 

Bits 3-5 Logical Unit Number: 

This 3-bit field specifies the SCSI Logical Unit Number, will be defined in these three bits. Refer to 
the SCSI-2 specification for a detailed description of Logical Unit Numbers. 

Bit 6 SCSI Bus Selection: 

This bit selects which of the two SCSI buses the board uses when executing the command. When 
this bit is cleared to 0, the board executes the command over the primary SCSI bus (Port 0). When 
set to 1, the board uses the secondary SCSI bus (Port 1). 

Bit 7: Extended Address Enable: 

This bit is cleared to 0 for SCSI-2 addressing (SCSI ID values 0-7). Extended addressing for SCSI-2 
Wide operation is enabled when this bit is set to 1 (for up to 32 devices). See Extended Unit Address 
below. 

Bits 8-15 Reserved: 

When bit 7 is cleared, bits 8-15 are reserved, and must be cleared to 0 by the host. 


W EMended Unit Address For SCSI-2 Wide Operation 

This field specifies the SCSI bus and the address of the target device for SCSI-2 Wide operation. 
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Extended Unit Address For SCSI Pass-Through Command 
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5 -- 

SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID; 0x20 Command ID: 0x20 


Bits 0>3 Extended SCSI Device ID: 

This 3-bit field contains the Extended SCSI ID used when addressing the target. This value may 
range from 0 to 15. 

Bit 4-5 Reserved: 

These bits are reserved and must be set to zero by the host. 

Bit 6 SCSI Bus Selection: 

This selects which of the two SCSI buses the board uses when executing the command. When this 
bit is cleared to 0, the board executes the command over the primary SCSI bus (Port 0). When set 
to 1, It uses the secondary SCSI bus (Port 1). 

Bit 7 Extended Address Enable; 

When this bit is set to 1, the LUN is taken from the 6-blt extended LUN field, and the SCSI device ID 
is taken from the 4-bit extended SCSI device ID field. 

Bits 8-13 Extended LUN: 

Setting Bit 7 enables the extension to both the LUN and the SCSI Device ID fields. 

Bits 14-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


SCSI Command Bytes 

The SCSI Command Bytes specify the bytes that the board passes unchanged across the SCSI bus 
to the selected SCSI device. The size of the SCSI Pass-Through lOPB can be adjusted to 
accommodate different SCSI command lengths. For example, to Issue a 12-byte SCSI command, 
append the 12-byte SCSI Command Descriptor Block (CDB) starting at word 0x10 of the lOPB. 

The board determines the length of the SCSI Command Descriptor Blocks by looking at the group 
code In SCSI Byte 0 of the lOPB (Table 5-4). 
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Commtmd Set 


ICSl PASS-THROUGH 

;ommand ID: 0x20 


SCSI PASS-THROUGH 

Command ID: 0x20 


Table 5-4 Group Codes For SCSI Commands 


GROUP 

CDB LENGTH 

0 

6 Bytes 

1 

10 Bytes 

2 

10 Bytes 

3 

(Reserved) 

4 

(Reserved) 

5 

12 Bytes 

6 

User Defined 

7 

User Defined 


If the commarKi is a Group 0,1, 2, or 5 SCSI comiriand, the board will "know” the length of the CDB 
(6,10, or 12 bytes, respectively), and the board will Ignore the lOPB Length field of the comesponding 
Command Queue entry. 

The lOPB Length field of the Command Queue entry for a user-defined SCSI command (Group 6 or 
7) must specify the length of the lOPB in words. The board calculates the CDB length by subtracting 
the overhead of the lOPB (0x10 words) from the length specified in the Command Queue entry. 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB of the 
command response for the SCSI Pass-Through command. 


Return Status (2 Bytes) 

This field provides the return status for the command. 
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..ERROR CODE 
..PASS-BACK STATUS 


Return Status For SCSI Pass-Through Command 
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5 -- 

SCSI PASS-THROUGH SCSI PASS-THROUGH 

Command ID: 0x20 Command ID: 0x20 


Bits 0-7 Error Code: 

The Error Code byte describes the status of the controller at the end of the command response. Any 
non-zero value is an error code. Appendix C contains the error codes. 

Bits 8-15 Pass-Back Status: 

This value is the SCSI status byte returned by the target device, it is not changed by the board. A 
value of 0x0 indicates Good Status. A non-zero value indicates that a SCSI device error has 
occurred. 


NOTE: The board can be configured to respond to a non-zero pass-back status by: 

• Freezing the queue, 

• Aborting ail commands in or destined for the queue, or 

• initiating autosense error recovery 

The work queue options are set via the Initialize Work Queue command, and are mutually 
exclusive. (See Work Queue Options, page 5-53 and Error Recovery Tools in Chapter 6 for 
details). 


BSaximum Trtxn^er Length Field (4 Bytesi 

This field, in the returned lOPB of the command reponse, reflects the actual number of bytes 
transferred. 


Sense Data Bytes (Variable Length) 

If the Autosense Error Recovery option is enabled and a SCSI check condition occurs, the sense data 
returned from the target device will be reported in the returned lOPB, overwriting the SCSI Command 
Descriptor Block (i.e. SCSI bytes 0-11) and possibly extending beyond. Autosense Recovery is 
enabled via the initialize Work Queue command. 
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Commcmd Set 


SCSI RESET 

Command ID: 0x22 


SCSI RESET 

Command ID: 0x22 


The SCSI Reset lOPB instructs the board to reset the SCSI bus identified by the command. It terminates 
all pending commands on the SCSI bus. A Command Complete with Error will be issued for each 
command terminated as a result of the SCSI Reset command. Normally, this command is used only In an 
to attempt to recover from an unusual error condition. 

When the host issues a Reset SCSI Bus lOPB through the Master Command Entry, all work queues with 
commands active on the specified SCSI bus will have those commands returned with a Command Aborted 
by Reset (during execution) or a SCSI Bus Reset Status Error. 

The work queues corresponding to those commands may be optionally frozen if the Freeze Work Queue 
on Reset option is enabled via the Initialize Controller command. (See Work Queue Options (page 5-53 
and Error Recovery Tools in Chapter 6 for details). 

NOTE: It may be necessary for the host to issue a SCSI Request Sense to on-line devices after 

executing the SCSI Reset command. This depends on what the device(s) require after a SCSI 
bus reset. Consult device manuals for details. 


Word # 

15 14 1 13 12 11 10 1 9 1 8 

BBDDBBIIB 

0X0 

COMMAND CODE (0x22) 

0x1 

COMMAND OPTIONS 

0x2 

RETURN STATUS 

0x3 

RESERVED 

0X4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

0x5 

INTERRUPT LEVEL 

m 

RESERVED 

OxE 

SCSI BUS ID 


NOTES: Fields set in Bold letters are returned values. The host provides all other values. 

Reserved fields must be set to 0 by the host. 

Figure 5-2 SCSI Reset lOPB 

The following section describes the function of each field in the SCSI Reset lOPB. 
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5 -- 

SCSI RESET SCSI RESET 

Command ID: 0x22 Command ID: 0x22 


Host-Pravided lOPB Fields 

The following information must be provided in the lOPB for the SCSI Reset command: 


Camnumd C€»de (2 Bytes) 

This field must be set to 0x22 to execute the SCSI Reset command. 

Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 

r"".B ' " II" II I I I I " I I II - T i ""u u" a II ir" 

B 15 I 14 I 13 « 12 a 11 II 10 II 9 I 8 I 7 8 6 I 5 II 4 II 3 II 2 B 1 II 0 II 

«- I " - " « » « nnuB II II /I II II II 

» . . ... I... — ' - I .- . — —I I—•Interrupt Enable 

t — .. ... ... > Reserved 

Command Options For SCSI Reset Command 
Bit 0 Interrupt Enable: 

Setting this bit enables the board to Interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


JYormal CampletUm Vectar/Eirror Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


II 15 i 14 a 13 ii 12 H 11 a 10 H 9 « 8 a 7 I 6 I! 5 I 4 11 3 i 2 i| 1 i| 0 i 

II -u-II r. 11 M .1 ,1 » H II II 'r ■■■ .'I ^ 

I-;-1 I-,-1 

I I-►ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For SCSI Reset Command 
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Command Set 


SCSI RESET 

Command ID: 0x22 


SCSI RESET 

Command ID: 0x22 


Bits 0<7 Error Compietion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normai Compietion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


I I ’ II If " ■ rIf II I I ' i r ' ”ii — " ff "r ■ nr ii v '"n~ t ” 

8 15 I 14 I 13 I 12 B 11 II 10 I 9 I 8 I 7 H 6 I 5 M II 3 I 2 II 1 « 0 II 

"T—“ - " - « ■’ » » » II n II II ^ IL . ^ ll_ JL 


1 I -►INTERRUPT LEVEL 

«-- RESERVED 

Interrupt Level For SCSI Reset Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed with a level of 0 allowed only when Interrupts are 
disabled by clearing the interrupt enable bit in the Command Options word. 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


SCSI Bus ID (2 Bytes) 

This field identifies which bus is to be reset. 
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5 -- 

SCSI RESET SCSI RESET 

Command ID: 0x22 Command ID: 0x22 
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RESERVED 
SCSI Bus Selection 


SCSI Bus ID For SCSI Reset Command 


Bits 0-14 Reserved: 

These bits are reserved and must be cleared to 0. 

Bit 15 SCSI Bus Selection: 

This bit selects which of the two SCSI buses the board uses when executing the command. When 
this bit is cleared to 0. the board executes the command over the primary SCSI bus (Channel 0). 
When set to 1, the board uses the secondary SCSI bus (Channel 1). 


Returned Values 

Upon command completion, the following information is provided by the board, in the returned lOPB of the 
command response, for the SCSI Reset command: 


Return Status (2 Bytes^ 

Upon successful completion of the SCSI Bus Reset, these two bytes will hold the value 0x0011, 
indicating that the lOPB has completed successfully, and has generated a reset on the specified bus. 
If interrupts are enabled for this lOPB, the error interrupt vector will be used. (This behavior is 
compatible with the Jaguar 4210.) 
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► ERROR CODE 

► PASS-BACK STATUS 


Return Status For SCSI Reset Command 
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Commcuid Set 


PRINTER PORT 

Command ID: 0x23 


PRINTER PORT 

Command ID: 0x23 


The Printer Port command is used to issue instructions to a printer connected to the optional printer port. 
Before issuing a Printer Port lOPB, the host must initialize a work queue and issue the port using the 
Initialize Printer Port command. (See Initialize Printer Port (page 5-95), and Printer Port Operation in 
Chapter 6 for complete instructions on use of the printer port.) 


The format of the Printer Port lOPB is shown in Rgure 6-3. 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Resen/ed fields must 
be cleared to 0 by the host. 


Figure 5-3 Printer Port lOPB 

The remainder of this section describes the function of each field in the Printer Port lOPB. 
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5 -- 

PRINTER PORT 

Command ID: 0x23 


PRINTER PORT 

Command ID: 0x23 


Host-Provided lOPB Fields 


The following information must be provided in the lOPB for the Printer Port command: 


Command Code (2 Bytesi 

This field must be set to 0x23 to execute the Printer Port command. 


Command Options (2 Bytes^ 


This field contains the options for this command. The bits are defined as follows: 
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I—INTERRUPT ENABLE 
—.RESERVED 
—.PAPER INSTRUCTION 
—.RESERVED 


Command Options For Printer Port Command 


Bit 0 interrupt Enable: 

Setting this bit enables the board to Interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 8 Paper instruction: 

Setting this bit causes the board to transfer ail of the data specified in this lOPB to the printer with the 
Paper instruction interface signal active. The Paper Instruction signal Is only supported by 
Dataproducts printers. 

Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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Command Set 


PRINTER PORT 

Command ID: 0x23 


PRINTER PORT 

Command ID: 0x23 


Normal Completion Vectar/Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 



I I-►ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 

Normal/Error Completion Vector For Printer Port Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


i 15 i 14 i 13 j 12 ii 11 i 10 ii 9 jj 8 ii 7 i 6 i 5 i 4 i 3 i 2 i 1 i 01 
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1 1-►INTERRUPT LEVEL 

I-- RESERVED 


Interrupt Level For Printer Port Command 


Bits 0-2 interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed with a level of 0 allowed only when interrupts are 
disabled by clearing the interrupt enable bit in the Command Options word. 
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PRINTER PORT PRINTER PORT 

Command ID: 0x23 Command ID: 0x23 


Bits 3-15 Reserved: 

These bits are resen/ed and must be cleared to 0 by the host. 


VME Transsfer Type (2 Bytes) 

This field specifies the address modifier, memory type, and transfer type to be used for all VMEbus 
transfers associated with the command. 

NOTE: Some memory systems may not support all of the options discussed for this field. 
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ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 


VME Transfer Types For Printer Port 


Bits 0-7 Address Modifier: 

This byte specifies the address modifier to be used by the board for all VMEbus data transfers 
associated with this command. 

Bits 8-9 Memory Type: 

This 2-bit field specifies the width of the data transfer. Table 5-5 shows the permitted values. 


Table 5-5 Memory Type For Printer Port Command 


BIT 9 

BITS 

MEMORY TYPE 

0 

0 

RESERVED 

0 

1 

16-BIT TRANSFERS 

1 

0 

32-BIT TRANSFERS 

1 

1 

RESERVED 
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Command Set 


PRINTER PORT PRINTER PORT 

Command ID: 0x23 Command ID: 0x23 


Bits 10-11 Transfer Type: 

This 2-bit field specifies the type of data transfer to be performed. Table 5-6 shows the permitted 
values. 

Table 5-6 Transfer Type For Printer Port Command 


BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL MODE 

0 

1 

BLOCK MODE 

1 

0 

RESERVED 

1 

1 

VME D64 Block 


Bits 12-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Buffer Address (4 Bytes) 

This field specifies the address in system memory at which the board will begin the data transfer. 
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Buffer Address For Printer Port Command 
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5 -- 

PRINTER PORT PRINTER PORT 

Command ID: 0x23 Command ID: 0x23 


Mtiximum Tntn^er Length (4 Bytes) 

This field specifies the maximum number of bytes that may be transferred by the command. 
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Maximum Transfer Length For Printer Port Command 


Printer Tranter Length (4 Bytes^ 

The Printer Transfer Length field Is used to specify the exact number of bytes to be transferred to the 
printer. 
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PRINTER TRANSFER LENGTH 







Printer Transfer Length For Printer Port Command 


NOTE: Entering a length of zero in both the Maximum Transfer Length field and in the Printer 

Transfer Length field causes the board to return the lOPB with the current printer status. 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB, of the 
command response, for the Printer Port command: 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. 
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Commcuid Set 


PRINTER PORT 

Command ID: 0x23 


PRINTER PORT 

Command ID: 0x23 


Printer Status (1 Bytei 

This field contains the state of the printer status control lines at the completion of the data transfer. 
Only those lines which were enabled when the printer port was initialized will be reported. The 
definition of the bits in this field vary depending on the printer type, as listed in Rgure 5-4. 


DATAPRODUCTS DEFINITION (ACTIVE HIGH) 

BIT? 

Software Readable Jumper 1 s Dataproducts, 0 s Centronics 

BITS 

Paper Movement 

BITS 

Top Of Form 

BIT 4 

Bottom Of Fom 

BITS 

Cable On 

BIT 2 

Parity Error 

BIT 1 

Online 

BITO 

Ready 


CENTRONICS STATUS DEFINITION (ACTIVE HIGH) 

BIT? 

Software Readable Jumper 1 « Dataproducts, 0 » Centronics 

BITS 

Busy 

BITS 

Resen/ed - value returned may be either 0 or 1 

BIT 4 

Resenred - value returned may be either 0 or 1 

BITS 

Resen/ed • value returned may be either 0 or 1 

BIT 2 

Paper Empty 

BIT1 

Select 

BITO 

Fault 


Figure 5-4 Definition Of Printer Status Bits 


Returned Values Far Printer Status Change Interrupt 

If status change interrupts were enabled when the printer port was initialized, the board generates an 
interrupt and posts the information shown below to the Command Response Block when a status change 
occurs. 
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PRINTER PORT 

Command ID: 0x23 



PRINTER PORT 

Command ID: 0x23 



Figure 5-5. Return Information For Printer Status Change Interrupt 


The Status Change bit (Bit 7) in the Command Response Status Word is set, and an image of the printer’s 
status lines is returned. The bits in the Printer Status field have the same definition as in the Printer Status 
field in the Printer Port lOPB (see Rgure 5-5 above). 

The value in the Return Code field should be 0x90 (Printer Status Change). 

NOTE: More than one status line may change in a single interrupt, so the entire status should be verified 

by the host. 
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Command Set 


PERFORM DIAGNOSTICS PERFORM DIAGNOSTICS 

I Command ID: 0x40 Command ID: 0x40 


The Perfomi Diagnostics command causes the board to perform a set of pass/fail self-diagnostic tests that 
are identical with those performed during the power-up self test. All of the tests are performed, and then 
the status of each test is reported back in the Command Response Block. Due to the nature of these tests, 
the Perform Diagnostics command cannot be executed while the board is operating. The board returns 
an error if this command is issued while ANY other command is queued. 

The Perform Diagnostics command must be issued through the Master Command Entry to Work Queue 0. 

This command cannot be reported back via an off-board Command Response Block, and no interrupt will 
be generated. 

After executing this command, it is necessary to reset the 4220 before issuing additional commands to it. 



NOTES; Fields set In bold capital letters are returned values. All other values are host provided. Reserved fields must 
be cleared to 0 by the host. 


Figure 5-6 Perform Diagnostic lOPB 


The remainder of this section describes the function of each field in the Perform Diagnostics lOPB. 
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PERFORM DIAGNOSTICS 

Command ID: 0x40 



PERFORM DIAGNOSTICS 

Command ID: 0x40 


Host-Provided IGPB Fields 

The following information must be provided In the lOPB for the Perform Diagnostics command: 


Command Code (2 Bytes) 

This field must be set to 0x40 to execute the Perform Diagnostics command. 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Perform Diagnostics command: 


ROM Test Residt (2 Byte^ 

These bytes return the status of the ROM Test. A test result of OxFFFF indicates that the test 
complete successfully. Any other value indicates that the test failed. 

\ 

Scratchpad RAM Test Result(2 Bytes) 

These bytes return the status of the Scratchpad RAM Test. A test result of OxFFFF Indicates that the 
test completed successfully. Any other value indicates that the test failed. 


Buffer RAM Test Result (2 Bytes) 

These bytes return the status of the Buffer RAM Test. A test result of OxFFFF indicates that the test 
completed successfully. Any other value indicates that the test failed. 


DMA Control Register Test (2 Bytes) 

These bytes return the status of the DMA Control Register Test. A test result of OxFFFF indicates 
that the test completed successfully. Any other value Indicates that the test failed. 


Primary SCSI Channel Register Test (2 Bytes) 

These bytes return the status of the Primary SCSI Channel Register Test. A test result of OxFFFF 
indicates that the test completed successfully. Any other value indicates that the test failed. 
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Command Set 


PERFORM DIAGNOSTICS PERFORM DIAGNOSTICS 

Command ID; 0x40 Command ID; 0x40 


SCSI Secondary Channel Register Test (2Bytes) 

These bytes return the status of the SCSI Secondary Channel Register Test. A test result of OxFFFF 
indicates that the test completed successfully. A status of PASS (OxFFFF) is also returned if this test 
is run on a motherboard with no daughter card installed. Any other value indicates that the test failed. 
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INITIAUZE CONTROLLER 

Command ID: 0x41 


INITIAUZE CONTROLLER 

Command ID: 0x41 


Initialize Controller configures the board for use in a particular system. The host must issue this command 
before the board can engage in any activity on the SCSI bus. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the 10PB for the Initialize Controller command is: 


Word # 


15 14 13 12 11 10 9 8 


3 2 1 


COMMAND CODE (0x41) 


COMMAND OPTIONS 


RETURN STATUS 


RESERVED 


NORMAL COMPLETION VECTOR 


INTERRUPT LEVEL 


RESERVED 


ERROR COMPLETION VECTOR 


ADDRESS MODIFIER 



MAXIMUM TRANSFER LENGTH 




NOTES: Fields sat in bold capital letters are returned values. All other values are host provided. Reserved fields must 
be cleared to 0 by the host. 


Figure 5-7 Initialize Controller lOPB 


The remainder of this section describes the function of each field in the Initialize Controller lOPB. 


















































Command Set 


INITIALIZE CONTROLLER INITIAUZE CONTROLLER 

Command ID; 0x41 Command ID: 0x41 


Host-Provided. lOPB Fields 

The following infomiation must be provided in the lOPB for the Initialize Controller command: 

Command Code (2 Bytes) 

This field must be set to 0x41 to execute the Initialize Controller command. 

Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 
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I-,-i I—.interrupt enable 

I-►RESERVED 


Command Options For Initialize Controller Command 


Bit 0 Interrupt Enable; 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normid Completion YectarfBrror (kmtpletion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


IT 


U. 


15 II 14 B 13 II 12 II 11 II 10 II 9 II 8 II 7 II G II 5 

1 ■ “ '' '' " " ■■ " 


—H 

0 H 


ERROR COMPLETION VECTOR 
NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Initialize Controller Command 
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Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


I I" I I II ■ "H" ' II II ' """11 ' ' II II II ' I I II II II ' " II I I II 

I 15 I 14 * 13 I 12 « 11 I 10 I 9 I 8 I 7 I 6 I 5 I 4 I 3 I 2 8 1 « 0 II 

" ' '■ " ■' ■■ " .1 » 5 ■■ I. 11 « ^ 11 -j-Ji- 

I-^-1 I-;-1 

I I -►INTERRUPT LEVEL 

I __ RESERVED 


Interrupt Level For Initialize Controller Command 


Bits 0-2 Interrupt Levei: 

These bits set the Interrupt level used by the board to assert a Command Complete interrupt on th 
e VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 In the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Address MtHlifier/Memory Type Tranter Type (2 Bytes) 

These bytes specify the address modifier, memory type, and transfer type to be used for all VMEbus 
transfers associated with the command. 
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» 15 I 14 II 13 II 12 II 11 II 10 II 9 11 8 II 7 B 6 H 5 B 4 II 3 II 2 11 1 n 0 II 



ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 


Address Modifier/Memory/Transfer Type For Initialize Controller Command 


Bits 0-7 Address Modifier: 


This byte must be cleared to 0x00 in the Initialize Controller Command. 


Bits 8-9 Memory Type: 


The only valid entry in this 2-bit field is 0x3 (data Is located In Short I/O space). 


BIT 9 

BITS 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

(RESERVED) 

1 

0 

(RESERVED) 

1 

1 

Data is contained in Short i/O 


Memory Type Field For Initialize Controller Command 


Bits 10-11 Transfer Type: 

This 2-bit field must be cleared to 0. 

Bits 12-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bu^er Address (4 Bytes) 

This field contains the offset of the Controller Initialization Block from the Short I/O base address. 
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15 

14 

13 

12 


10 

9 

8 

B 

6 

5 

n 

3 

2 

1 

0 

MSW 

LSW 





BUFFER ADDRESS 








Buffer Address For Initialize Controller Command 


Maximum Transfer Length (4 Bytes) 

This field specifies the maximum number of bytes that may be transferred by the command, and 
represents the size of the Controller Initialization Block. 

NOTE: An incorrect value in this field may cause the initialization parameters to be ignored. 


IS 

CM 

CO 

R 

10 


8 

BB 

5 

4 

3 

2 

n 

m 

MSW 

LSW 


MAXIMUM TRANSFER LENGTH 







Maximum Transfer Length For Initialize Controller Command 
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INITIALIZE CONTROLLER 

Command ID: 0x41 


Controller InitializatUm Block 

The Buffer Address of the Initialize Controller lOPB points to a list of initialization parameters called the 
Controller Initialization Block (CIB), The host must assemble the Controller Initialization Block in the Host 
Usable Space (HUS) before issuing the Initialize Controller command. Once it issues the Initialize 
Controller command, the host cannot modify the CIB until the Initialize Controller command has completed 
interrupt for the initialize command. The format is as follows: 


Figure 5-8 Controller Initialization Block 


WORD 

15 14 13 12 1 11 10 9 8 

m 

1 

B 

1 

0x0 

NUMBER OF COMMAND QUEUE ENTRIES IN SHORT I/O 

0x1 

DMA BURST COUNT 

0x2 

CONTROLLER NORMAL COMPLETION LEVEUVECTOR 

0x3 

CONTROLLER ERROR COMPLETION LEVELA/ECTOR 

0x4 

PRIMARY SCSI BUS ID 

0x5 

SECONDARY SCSI BUS ID 

0x6 

COMMAND RESPONSE BLOCK OFFSET 

0x7 

SCSI SELECTION TIMEOUT (IN MILLISECONDS) 

0x8 

0X9 

WORK QUEUE 0 COMMAND TIMEOUT 

OxA 

OxB 

VMEBUS TIMEOUT (0 = 100msec TIMEOUT) 

OxC 

OxD 

RESERVED 

OxE 

OxF 

OFFBOARD CRB VME TRANSFER TYPE 

0x100 

OFFBOARD COMMAND RESPONSE BLOCK ADDRESS 
(In Host Memory) 

0x11 

0x12 

ERROR RECOVERY OPTIONS 

0x13 

RESERVED 

0x14 

RESERVED 

0x15 

SCSI Bus Reset Interrupt Vector 

0x16 

Synchronous Offset (Bus 0) 

Synchronous Negotiation Rate (Bus 0) 

0x17 

Synchronous Offset (Bus 1) 

Synchronous Negotiation Rate (Bus 1) 
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The following is a description of each field in the Controller Initialization Block. 


Number of (Umunand Queue Entries (2 Bytes) 

This field sets the number of entries in the Command Queue. The Command Queue must have at 
least one entry. The maximum number of entries varies greatly depending on the application. If you 
are using onboard lOPBs, which require that both the Command Queue entry and its corresponding 
lOPB be written to Host Usable Space in Short I/O, the maximum number of entries is relatively 
limited. A typical setup for onboard lOPBs is a 10-entry Command Queue. 

NOTE: Each CQE/IOPB only resides In Short I/O for a very short period of time before being 

transferred Into the appropriate work queue. 

A much larger Command Queue is allowed in applications using offboard lOPBs, in which the board 
DMAs lOPBs directly from system memory into the appropriate work queue. Nevertheless, the size 
of the Command Queue is still application-dependent. The maximum number of Command Queue 
entries in a setup using offboard lOPBs deperKis on the size of Short I/O and application 
requirements. See Offboard lOPBS in Chapter 6. 


DMA Burst Count (2 Bytes) 

The controller has two distinct burst modes—Burst Count Mode and Time On/Time Off Fair Arbitration 
Mode. This serves to retain backward compatibility as well as to provide more flexibility in controlling 
bursts on the VMEbus. 

Burst Count Mode: 

Burst Count Mode is enabled by clearing the bit 15 (Burst Mode) to 0. 


j 15 ! 14 J 13 i 12 i 11 i 10 

" 1 ■■ I » ‘‘ ■■ 


L 


J 9 S 8 J 7 j 6 ii 5 i 4 i 3 i 2 i 1 li 0 i 

- 1 (-,- 1 

I-- Burst Count 

-- Reserved 

--Burst Mode = 0 


Burst Count Mode Enabled 


When Burst Mode is enabled, the bits in this field have the following meaning. 
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INITIAUZE CONTROLLER 

Command ID: 0x41 


Bits 0*7 Burst Count: 

This field defines how long the tx)ard will hold on to the VMEbus before releasing it. 

If the burst count is 0, the board will request the bus, and upon being granted the bus will transfer 
data until there is no more data to be transferred. 

if the burst count is greater than 0, but less than 0x21. the board will request the bus, and upon being 
granted the bus, will transfer data until there is no more data to be transferred, or 16 microseconds 
has elapsed since being granted the bus, or one of the bus request lines on the VMEbus is asserted. 

If the burst count is greater than 0x20, but less than 0x41, the board will request the bus. and upon 
being granted the bus, will transfer data until there is no more data to be transferred, or 16 
microseconds has elapsed since being granted the bus. 

If the burst count is greater than 0x40, but less than 0x81, the board will request the bus, and upon 
being granted the bus, will transfer data until there Is no more data to be transferred, or 32 
microseconds has elapsed since being granted the bus. 

If the burst count is greater than 0x80, the board will request the bus, and upon being granted the 
bus, will transfer data until there is no more data to be transferred, or 64 microseconds has elapsed 
since being granted the bus. 


Burst Count 

Function 

0x00 

Keep the VMEbus until ck>ne. 

0x01-0x20 

Keep the VMEbus 16 microseconds or until 

BRx is asserted by another board. 

0x21-0x40 

Keep the VMEbus 16 microseconds. 

0x41-0x80 

Keep the VMEbus 32 microseconds. 

0x81-OxFF 

Keep the VMEbus 64 microseconds. 


VMEbus Burst Count Settings 


Bits 8-14 Reserved: 

These bits are reserved and must be set to zero. 
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Bit 15 Burst Mode: 

The value of this bit determines how the CIB DMA Burst Count value Is used. If the Burst Mode bit 
is set to 1, the Time On/Time Off and Fair Arbitration fields have meaning. If the Burst Mode bit is 
set to 0, the Burst Count field has meaning. 


Time On/Time Off Fair Arbitration Mode 

Setting the mode bit in bit 15 enables Time On/Time Off Fair Arbitration Mode instead of Burst Count 
Mode. This mode causes the bits in this field to be defined as follows: 


IS S 14 H 13 II 12 II 11 « 10 II 9 II 8 II 7 n 6 II 5 n 4 


3 II 2 II 1 I 0 II 
, II I il ■■■■■••■. II 


► Time On 

► Reserved 
►Time Off 

► Reserved 

• Fair Arbitration 
►Burst Mode = 1 


Time On/Time Off Fair Arbitration Mode Enabled 


Bits 0-2 Time On 

This field defines how long the board will hold on to the VMEbus before releasing it. 


Bit 2 

Bit 1 

BitO 

Elapsed Time 

0 

0 

0 

16 Microseconds 

0 

0 

1 

32 Microseconds 

0 

1 

0 

64 Microseconds 

0 

1 

1 

128 Microseconds 

1 

0 

0 

256 Microseconds 

1 

0 

1 

512 Microseconds 

1 

1 

0 

1024 Microseconds 

1 

1 

1 

When Done 
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Bit 3 Reserved; 

This bit is resen/ed and must be set to zero by the host. 


Bits 4-6 Time Off: 

This field defines how long the board will wait after releasing the VMEbus before requesting it again. 


Bite 

Bits 

Bit 4 

Eiapsed Time 

0 

0 

0 

0 Microseconds 

0 

0 

1 

16 Microseconds 

0 

1 

0 

32 Microseconds 

0 

1 

1 

64 Microseconds 

1 

0 

0 

128 Microseconds 

1 

0 

1 

256 Microseconds 

1 

1 

0 

512 Microseconds 

1 

1 

1 

1024 Microseconds 


Bits 7-13 Reserved; 

These bits are reserved and must be set to 0 by the host. 

Bit 14 Fair Arbitration: 

Setting this bit will cause the board to sample the Bus Request (BRx) signal on the VMEbus before 
asserting BRx. If the BRx signal is already asserted, then the board will wait until BRx is negated 
before asserted BRx. If this bit is clear, the board will assert BRx whenever the board requires the 
VMEbus. 

Bit 15 Burst Mode; 

The value of this bit determines how the CIB DMA Burst Count value is used. If the Burst Mode bit 
is set to 1. the Time On/Time Off and Fair Atribute fields have meaning. If the Burst Mode bit is set 
to 0, the Burst Count field has meaning. 
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Controller Normal Completion Level/Vector (2 Bytes) 


This field specifies the VMEbus interrupt level and vector that the board will use to report the normal 
command completion. 


H ' I I ■ " II .1 I I II " I I I I II ■ 

8 15 B 14 II 13 a 12 B 11 II 10 li 9 B 8 II 7 

■■ _ ■■ " " " , " , " " , ” , 


6 I 5 


II " I I' — HI I I ' I I 

H 3 II 2 B 1 II 0 I 


INTERRUPT VECTOR 
INTERRUPT LEVEL 
RESERVED 


Controller Normal Completion LevelA/ector For Controller Initialization Block 


Bits 0-7 Interrupt Vector: 

This level specifies the interrupt vector used by the board when reporting normal controller interrupts. 

Bits 8-10 Interrupt Level: 

This level specifies the interrupt level used by the board when reporting normal controller interrupts. 
The host sets these bits and the board does not modify them. 

Bits 11-15 Reserved: 

Bits 11 through 15 are reserved and should be cleared to 0 by the host. 


Controller Error Completion Level/Vector (2 Bytes) 

This field specifies the interrupt level and vector that the board will use when reporting a variety of 
controller errors. Such errors will not generate an interrupt if the interrupt level is set to 0. However, 
the board will still report such errors in the Command Response Block. For additional information on 
this field, refer to Controller Error Interrupt and Vector. 


i 15 i 14 i 13 li 12 i 11 i 10 i 9 i 8 i 7 ii 6 i 5 j 4 i 3 12 i 1 ij 0 || 

» , " - 1 ^ ■' ■' » " ■■ " '■ ' " 

I - 1 - 1 I -^— I i -^- i 

! i '- 

I I- 

I 


INTERRUPT VECTOR 
INTERRUPT LEVEL 
RESERVED 


Controller Error Completion LevelA/ector For Controller Initialization Block 
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Bits 0-7 Interrupt Vector: 

This byte is the interrupt Vector used by the board when reporting Controller Error Interrupts, 

Bits 8-10 Interrupt Level: 

These bits set the Interrupt Level used by the board when reporting the Controller Error Interrupts. 
Bits 11-15 Reserved: 

Bits 11 through 15 are reserved and should be cleared to 0 by the host. 


Primary SCSI Bus JD (2 Bytes) 


The Primary SCSI Bus ID specifies the ID the board uses for its SCSI bus address on Channel 0. 
The board can either use its default ID, set via hardward jumpers, or it may use the value given in bits 
0 through 2. 


B 15 « IM 13 I 12 « n B 10 j 9 

“ -I ” - '■ " ■■ " 
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8 I 7 B 6 B 5 M B 3 II 2 8 1 
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L 


II 0 


T 

J 


EXTENDED PRIMARY SCSI BUS ID 
RESERVED 

EXTENDED ADDRESSING = 1 
DEFAULT 

PRIMARY SCSI BUS ID 
(IGNORED BY BOARD) 


-PRIMARY SCSI BUS ID 
-DEFAULT 

-EXTENDED ADDRESSING = 0 
-RESERVED 


Primary SCSI Bus ID For Controller initialization Block 


Bits 0-2 Primary SCSI Bus ID (when Bit 3 = 0): 

If Bit 3 is cleared, the value stored in this field will be used by the board as its Primary SCSI Bus ID. 
This field may have any value from 0x0 to 0x7. When Bit 3 Is set to “1" the Primary SCSI Bus ID is 
determined by the Primary SCSI Bus ID hardware jumper. Refer to chapter 2 for the identification and 
location of this jumper. 

Bit 3 Default: 

Setting the DEFAULT bit to “1" enables the board to use its jumper-selected primary SCSI ID (Chapter 
2). Clearing the DEFAULT bit to "0" causes the board to use the ID specified in the ID field (bits 0-2) 
of this word. 
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Bits 5-15 Reserved (when Bit 3 = 0): 

When Bit 3 is cleared to “0" these bits are reserved and must be cleared to 0 by the host. 


Bit 4 Extended Address Enabie = 0: 

When this bit is cleared, the fields of the Primary SCSI Bus ID are defined as indicated above. The 
primary SCSI Bus ID may contain values from 0x0 to 0x7. When this bit is set, a field large enough 
for wide SCSI Bus IDs is enabled. 



PRIMARY SCSI BUS ID (ID) 
DEFAULT (DFT) 
RESERVED 


Primary SCSI Bus ID For Controller Initialization Block 


Bits 0-3 Reserved (when Bit 4 = 1): 

These bits are ignored by board when bit 4 (Extended Address Enable bit) is set to “1". 

Bit 4 Extended Address Enabie = 1 

This bit is cleared to 0 for SCSI - 2 operation (values 0-7). Extended addressing for SCSI-2 wide 
operation is enabled when this bit is set to 1. 

Bit 5-7 Reserved (when Bit 4 = 1) 

These bits are cleared to "0" when bit 4 is set to "1". 

Bits 8-15 (when Bit 4 = 1) 

This field allows a range of values from 0 to 255. 

When the Extended Address Enable bit is set to 1, and the Default bit is cleared to 0, the Cougar 
SCSI ID is defined by the value of bits 8-15. This value may range from 0 to 15. 

NOTE: The Cougar II wide board currently supports 15 devices per SCSI channel, according to the 
SCSI-2 specification. 
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Secondary SCSI Bus ID (2 Bytes) 


The Secondary SCSI Bus ID specifies the ID the board uses for its SCSI bus address on Channel 1. 
The board can either use its default ID or it may use the value given in bits 0 through 2. 


,-►EXTENDED SECOND. SCSI BUS ID 

1 ,-►RESERVED 

I 1 ,-►EXTENDED ADDRESSING = 1 

I 1 I ,-►DEFAULT 

1 III I -►PRIMARY SCSI BUS ID 

,- 1 -, I- \ -, 1 1 I-i-, (IGNORED BY BOARD) 

II ' I I M l' " ' .I I .I I """ ' If I I ''ll'l l ^ ' l l . '(I'*'11' * II '* I I ‘ I I 

II 15 II 14 II 13 II 12 II n H 10 II 9 i 8 B 7 II 6 II 5 II 4 II 3 II 2 II 1 II 0 || 

, '■ - ” - ■' ■' '■ “ I •' " " 

1-^-i I 1 1---i 

I I I I-.SECONDARY SCSI BUS ID 

1 I I-►DEFAULT 

( I -►EXTENDED ADDRESSING = 0 

I-- RESERVED 


Secondary SCSI Bus ID For Controller Initialization Block 


Bits 0-2 Secondary SCSI Bus ID (when bit 3 = 0): 

The host uses these 3 bits to specify the SCSI ID the board is to use for Channel 1 when the Default 
bit (bit 3 = 0) is 0. This field may have any value from 0x0 to 0x7. 

Bit 3 Defauit: 

Setting the Default bit to "1" enables the board to use the default ID specified by the SCSI daughter 
card’s jumpers . Clearing the Defauit bit to "0" causes the board to use the ID specified in the ID field 
(bits 0-2) of this word. 

Bits 5-15 Reserved (when bit 4 = 0): 

When bit 4 Is cleared to “0" these bits are reserved and must be cleared to 0 by the host. 


W Extended Secondary SCSI Bus ID 


Commcmd Response Bloclc Offset (2 Bytes) 

The Command Response Block (CRB) Offset specifies the starting address of the CRB. By setting 
the CRB offset, the host is also specifying the length of the largest lOPB that can be transferred to 
the board. The largest lOPB is equal to the offset of the Controller Specific Space (0x788) minus the 
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CRB offset, minus 12 bytes. If the CRB offset is 0x73C. for example, the largest lOPB cannot exceed 
64 bytes (0x788 - 0x73C - OxC). 

The CRB offset must allow for a Command Response Block of at least 18 bytes so that there will 
always be enough room in the CRB to include the status bytes of the returned lOPB. Attempting to 
use a CRB offset that would result in a CRB of less than 18 bytes will result in the Initialize Controller 
Command completing with an error. 

If SCSI Autosense Error Recovery Is to be enabled, additional space must be allocated in the CRB 
offset for the SCSI sense data to be returned. The sense data will be returned in the Command 
Response Block starting with the first byte of the Command Descriptor Block in the returned lOPB. 
This data may extend to the beginning of the Configuration Status Block. The amount of sense data 
that the board requests from the device and returns in the CRB is determined by space from the CRB 
to the CSB, up to 255 bytes. If the data is being reported to an offboard CRB, the host must ensure 
that adequate space exists for this data to be written without generating system bus errors. 


SCSI Selection Timeout (4 Bytes) 

The SCSI Selection Timeout is 250 milliseconds and cannot be changed. 


Work Queue O Command Timeout (4 Bytes) 

This timeout specifies a timeout value for commands issued through Work Queue 0. This field is 
specified In Increments of approximately 256msec. A value of 0 specifies no timeout. The board 
notifies the host of an lOPB timeout by use of the Controller Error interrupt. This interrupt will be used 
to return error status without returning the lOPB that caused the error. Bit 7 of the Command 
Response Status Word allows the allows the host to determine the source of the error. Also data 
returned In the command response block has been defined to specify the type of error that has 
occurred. 


VMEbus Timeout (4 Bytes) 

VMEbus Timeout is not supported by Cougar II. This field is reserved. 

Offboard VME Tranter Type (2 Bytes) 

This field is intended for applications which use the board’s offboard lOPB feature (see Offboard 
lOPBs In Chapter 6). If this field and the Offboard Address field (below) are "0", the board will post 
the to the Short I/O space only. If these fields are non-zero, then the board will also post the to the 
specified offboard address. 

The values in this field are used when writing the to system memory. The illustration below shows the 
format of this word: 
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Bits 0-7 Address Modifier: 


15 B U II 13 « 12 II 11 B 10 II 9 II 8 B 7 II 6 

" ■' ■■ . “ . " ■ ■ " [ " ■ » 


5 « 4 B 3 i 2 B 1 I 0 


ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 


VME Transfer Type for Block Offboard Command Response 


This byte is the VMEbus address modifier used for writing the to system memory. This byte is not 
changed by the board. 

Bits 8-9 Memory Type: 

This two-bit field specifies the width of the data transfer used to write to the offboard. Permitted 
values are as follows: 


BITS 

BITS 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

16-BIT TRANSFERS 

1 

0 

32.BIT TRANSFERS 

1 

1 

(RESERVED) 


Memory Type Field For Offboard Command Response Block 

Bits 10-11 Transfer Type: 

This two-bit field specifies the type of transfer performed. Permitted values are as follows: 
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BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL MODE 

0 

1 

BLOCK MODE 

1 

0 

(RESERVED) 

1 

1 

VME D64 BLOCK 


Transfer Type Field For Offboard Command Response Block 


Bits 12-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


OfflxHMrd Command Response Block Address (4 Bytesi 

This field is intended for applications which use the board’s offboard lOPB feature (see Offboard 
lOPBs in Chapter 6). This address is used to write the Command Response Block to host system 
memory. If this field and the Offboard Transfer Type field are both 0, the board will post lOPBs to the 
In Short I/O only. 


Error Recovery Options (2 Bytes) 

This field is used to enable error recovery options. The following options are supported: 

• Freeze Work Queues on SCSI Reset 

• Host Interrupt on SCSI Reset 

• Report SCSI Error 

• Freeze All on SCSI Reset 


i 15 j 14 i 13 i 

tt-p-j—^—i 

t 


2 ii 11 i 10 i 9 i 8 i 7 i 6 i 5 i 4 I 3 i 2 i 1 li 0 il 


I III '—‘FREEZE WORK QUEUE 

1 1 1 1 ON SCSI RESET 

I I 1 :-‘SCSI BUS RESET INTERRUPT 

I 1 I-‘REPORT SCSI ERROR (RSE) 

1 I-‘FREEZE ALL ON SCSI RESET 

I-- RESERVED 


Error Recovery Options For Controller Initialization Block 
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INITIALIZE CONTROLLER 

Command ID: 0x41 


Bit 0 Freeze Work Queue On SCSI Bus Reset: 

Setting this bit causes the board to freeze a work queue if a Reset occurs on the SCSI bus while a 
command from that vyork queue is active on the bus. With this feature enabled, the host "knows" the 
work queue is frozen if a command is returned from the queue with a SCSI bus reset error status. 
This allows the host to decide how to handle the SCSI reset before permitting new commands to be 
sent to the device. This is the preferred mode of operation. In general, this bit should only be cleared 
to maintain driver backward compatibility prior to implementation of this feature. 


Bit 1 SCSI Bus Reset Interrupt: 

Setting this bit causes the board to Interrupt the host if a reset occurs on the SCSI bus while the 
board is idle. SCSI reset interrupts are generated when SCSI bus reset is detected. The SCSI reset 
bit in the Command Response Status Word (CRSW) is also set in the returned lOPB. 

Bit 2 Report SCSI Errors: 

Setting this bit causes the board to report non-recoverable SCSI errors via a controller error with the 
SCSI Error bit in the CRSW, providing additional diagnostic infonnation about the nature of the error. 
After a non-recoverable SCSI error is reported, the SCSI channel may be returned to functional status 
by issuing a SCSI bus reset. When this bit is cleared, non-recoverable SCSI errors produce a 
controller panic, requiring a full controller re-initialization to return the system to functional status. 

Bit 3 Freeze All on SCSI Bus Reset: 

Setting this bit causes all work queues on a channel to be frozen In the event of a third-party SCSI 
bus reset. 

Bits 4-12 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


SCSI Bus Reset Interrupt Vector/Level (2 Bytes) 

This field specifies the interrupt level and vector that the board will use when reporting a SCSI bus 
reset. An Interrupt will not be generated if the interrupt level is set to 0. However, the board will still 
report SCSI Bus Reset in the. 
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II " " H' II ' II I II ’ !! " 'H I I 'l l II . ' T ~ T " 'l l I I II I I 
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SCSI Bus Reset Interrupt Vector/Level for Controller Initialization Block 


Bits 0-7 SCSI Bus Reset interrupt Vector: 


This byte is the VMEbus Interrupt Vector used by the board when reporting SCSI Bus Reset 
Interrupts. 


Bits 8-10 SCSI Bus Interrupt Level: 


This value specifies the VMEbus Interrupt Level used by the board when reporting the SCSI Bus 
Reset interrupt. 


Bits 11-15 Reserved: 


Bits 11 through 15 are reserved and should be cleared to 0 by the host. 


Synchronous Offset for Bus O (2 Bytes) 

Referring to the SCSI-2 specification Synchronous Data Transfer Request table, this value is used for 
the REQ/ACK offset (byte 4) to set the maximum REQ/ACK offset that may be used on bus 0. 


Synchronous Negotiation Rate for Bus O (2 Bytes) 

Referring to the SCSI-2 Specification for Synchronous Data Transfer Request table, this value Is used 
for byte 3. The transfer period to set the minimum transfer period In nanoseconds divided by 4 that 
may be used on bus 0. 


Synchronous Offset for Bus 1 (2 Bytes) 

Controls parameter for SCSI bus 1. 


Synchronous Negotiation Rate for Bus 1 (2 Bytes) 

Controls parameter for SCSI bus 1. 
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INITIAUZE CONTROLLER INITIALIZE CONTROLLER 

Command ID; 0x41 Command ID: 0x41 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB of the 
command response for the Initialize Controller command: 


Return Status (2 Bytes) 

This field provides the return status of the command. Any non-zero value indicates an error code. 
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Return Status For Controller Initialization 
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INITIAUZE WORK QUEUE INITIAUZE WORK QUEUE 

Command ID: 0x42 Command ID: 0x42 


The initialize Work Queue command is used to configure the work queues (as reported in the CSB, see 
page 3-23). Each work queue must be initialized with a separate Initialize Work Queue command. 

NOTE: Work Queue 0 is auto-initialized by the board upon power-up and cannot be reinitialized. This 
command must be issued through the Master Command Entry to Work Queue 0. 

The format of the initialize Work Queue lOPB is as follows: 



NOTES: Fields set in bold letters are returned values. All other values are host provided. Reserved fields must be cleared 
to 0 by the host 


Figure 5-9 Initialize Work Queue lOPB 

The remainder of this section describes the function of each field in the Initialize Work Queue lOPB. 










































Command Set 


INITIAUZE WORK QUEUE INITIAUZE WORK QUEUE 

Command ID: 0x42 Command ID: 0x42 


Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Initialize Work Queue command: 


Command Code (2 Bytes) 

This field must be set to 0x42 to execute the Initialize Work Queue command. 


Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 
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I-,-1 I—►interrupt enable 

I-- RESERVED 


Command Options For Initialize Work Queue Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal tknnpletion Vector/Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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Normal/Error Completion Vector For Initialize Work Queue Command 
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5 -^- 

INITIAUZE WORK QUEUE INITIALIZE WORK QUEUE 

Command ID: 0x42 Command ID; 0x42 


Bits 0-7 Error Completion Vector: 

This value specifies the intenupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the Interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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I I -►INTERRUPT LEVEL 
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Interrupt Level For Initialize Work Queue Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, with a level of 0 is allowed only when interrupts are 
disabled by clearing the Interrupt Enable bit in the Command Options word. 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Work Queue Number (2 Bytes) 

This number identifies which work queue to initialize. Each work queue must be assigned a unique 
number. Valid entries in this field are 0x1-OxE to initialize work queues 1-14, for Cougar II, and 0x1 - 
Oxff to initialize work queues 1 - 255 for Cougar 11 Wide. 

Work Queue Options (2 Bytes) 

This field is used to set a variety of options that apply ONLY to the work queue being initialized. 
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INITIAUZE WORK QUEUE INITIALIZE WORK QUEUE 

Command ID; 0x42 Command ID; 0x42 



I I I I I I—►ABORT ENABLE 

I I I I I-.RESERVED 

I 1 I I-.FREEZE ON ERROR 

I 1 I-.PARITY ENABLE 

1 I-.ENABLE AUTOSENSE RECOVERY 

I-.REPORT FROZEN WORK QUEUE 

-- RESERVED 

-.INITIALIZE WORK QUEUE 


Work Queue Options For Initialize Work Queue Command 


Bit 0 Abort Enable; 

Setting this bit enables the board to abort all lOPBs in the work queue, and all lOPBs in the 
Command Queue destined for the work queue, when an lOPB from this queue completes with a SCSI 
Pass-Through error. 

Clearing this bit disables the option. See Queue Entry Control Register, Abort Acknowledge bit. 

Bit 1 Reserved; 

This bit Is reserved and must be cleared to 0 by the host. 

Bit 2 Freeze on Error; 

Setting this bit causes the queue to "freeze" if a SCSI Pass-Through lOPB sent to this queue fails to 
return a good status (0x0) in the Pass-Back status byte of the Return Status word. 

When the host sees a command return from a work queue that has Freeze on Error enabled with a 
SCSI pass-through error, the host must unfreeze (thaw) the work queue after taking the error handling 
steps needed for that particular error. 

The frozen work queue is thawed by selecting that work queue number in the Thaw Queue Register 
and then setting Bit 0 of that register. The board will clear the register to acknowledge the thawing 
of the work queue. The Thaw Work Queue Status Register Is located in the Master Control/Status 
Block. For details on using the freeze work queue feature, see Chapter 6, Error Recovery Tools 
(Chapter 6). 

Bit 3 Parity Enable; 

The Parity Enable bit enables SCSI bus parity checking for commands issued from the work queue. 
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5 -- 

INITIAUZE WORK QUEUE INITIAUZE WORK QUEUE 

Command ID: 0x42 Command ID: 0x42 


Bit 4 Enable Autosense Recovery: 

Setting this bit configures the board to send an automatic SCSI request sense command to a device, 
associated with this queue, from which a command is returned with a SCSI Check Condition in the 
pass-back status. The sense data is reported in the returned lOPB of the SCSI Pass-Through 
command that completed with a pass-through error. 

Setting this bit takes precedence over the "Freeze on Error Option", In the Work Queue Options field. 
Bit 5 Report Frozen Work Queue: 

When this bit is set and a queue is frozen, the frozen queue status will be reported with the Queue 
Frozen bit set in the CRSW of the command response of the command causing the queue to freeze. 

Bits 6-14 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 15 initialize Work Queue: 

The Initialize Work Queue bit causes the board to initialize the work queue even If it has previously 
been initialized. If commands are pending when the board attempts to execute an Initialize Work 
Queue command, the initialize Work Queue lOPB will not be executed, and the iOPB will return with 
error status. 


Number Of Slats (2 Byte^ 

This field is retained for backward compatibility with the 4210 Jaguar. It is not used by the 4220, and 
will only be passed back in the command response for the Dump Work Queue Parameters command. 


Unit Address 

This field specifies the SCSI bus and the address of the target device. 
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Initialize Work Queue Command 
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INITIALIZE WORK QUEUE INITIAUZE WORK QUEUE 

Command ID: 0x42 Command ID: 0x42 


W Extended Unit Address For SCSI-2 Wide Operation 

This field specifies the SCSI bus and the address of the target device for SCSI-2 Wide operation. 
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EXTENDED SCSI DEVICE ID 

-RESERVED 

-SCSI BUS SELECTION 

-EXTENDED ADDRESS ENABLE=1 

-EXTENDED LUN 

-RESERVED 


Extended Unit Address For Initialize Work Queue 


Bits 0-3 Extended SCSI Device ID: 

This 3-bit field contains the Extended SCSI ID used when addressing the target. This value may 
range from 0 to 15. 

Bit 4-5 Reserved: 

These bits are reserved and must be set to zero by the host. 

Bit 6 SCSI Bus Selection: 

This selects which of the two SCSI buses the board uses when executing the command. When this 
bit is cleared to 0, the board executes the command over the primary SCSI bus (Port 0). When set 
to 1, it uses the secondary SCSI bus (Port 1). 

Bit 7 Extended Address Enable: 

When this bit is set to 1, the LUN is taken from the 6-bit extended LUN field, and the SCSI device ID 
is taken from the 4-bit extended SCSI device ID field. 

Bits 8-13 Extended LUN. 

Setting Bit 7 enables the extension to both the LUN and the SCSI Device ID fields. 

Bits 14-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


5-55 




Chapter 


5 -- 

INITIAUZE WORK QUEUE INITIAUZE WORK QUEUE 

Command ID: 0x42 Command ID: 0x42 


Command Timeout (2 Byte^ 

This field specifies the maximum time that a command issued to this work queue should take to 
execute after the device has been selected, allowing each work queue a unique timeout value. The 
timeout period is from the successful completion of the selection phase until the completion of the 
command on the SCSI bus, including disconnect periods and is specified in increments 
of approximately 256 milliseconds. That is, a value of 0x1 in this field specifies a timeout period of 
approximately 256 milliseconds. 

If the timeout value is non-zero, the board will notify the host of the command timeout by use of the 
Controller Error Interrupt. This interrupt returns an error status without returning the lOPB that caused 
the error. Bit 7 of the allows the host to determine the source of the error. Also, data returned in the 
can be used to help determine the type of error that has occurred. 


Returned Values 

Upon command completion, the following information is provided by the board In the returned lOPB for the 
Initialize Work Queue commarKl. 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. 
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INITIAUZE WORK QUEUE 

Command ID: 0x42 


INITIALIZE WORK QUEUE 

Command ID: 0x42 


Bits 0-7 Error Code: 

The Error Code byte describes the status of the controller at the end of the command response. Any 
non-zero vaule is an error code. Appendix C contains a complete list of error codes. 

Bits 8-15 Pass-Back Status: 

This value is the SCSI status byte returned by the target device. 



Pass Back Status For Initialize Work Queue 



5-57 







Ctmpter 



DUMP INITIAUZATION PARAMETERS DUMP INITIALIZATION PARAMETERS 

Command ID: 0x43 Command ID: 0x43 


The Dump Initialization Parameters command causes the board to report its current initialization/setup 
information to the host. This command is intended to be used primarily for diagnostic purposes. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB for the Dump Initialization Parameters command is shown below: 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must 
be cleared to 0 by the host. 


Figure 5-10 Dump Initialize Parameters lOPB 

The remainder of this section describes the function of each field in the Dump Initialization Parameters 
lOPB. 




















































Command Set 


DUMP INITIAUZATION PARAMETERS DUMP INITIAUZATION PARAMETERS 

Command ID: 0x43 Command ID: 0x43 


Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Dump Initialization Parameters command: 

Command Code (2 Bytes) 

This field must be set to 0x43 to execute the Dump Initialization Parameters command. 


Command Optians (2 Bytesd 

This field contains the options for this command. The bits are defined as follows: 
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Command Options For Dump Initialization Parameters Command 


Bit 0 interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal Completion Vector/Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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Normal/Error Completion Vector For Dump Initialization Parameters Commands 
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DUMP INITIAUZATION PARAMETERS DUMP INITIALIZATION PARAMETERS 

Command ID; 0x43 Command ID; 0x43 



Bits 0-7 Error Completion Vector; 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector; 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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Interrupt Level For Dump Initialization Parameters Command 


Bits 0-2 Interrupt Level; 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 Is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 In the Command Options word). 

Bits 3-15 Reserved; 

These bits are reserved and must be cleared to 0 by the host. 


Memory TypetTransfer Type/Address Mifdifier(2 Bytes) 

This specifies the memory type and address modifier to be used for any VMEbus transfers associated 
with the Dunrp Initialization Parameters command. 
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DUMP INITIAUZATION PARAMETERS DUMP INmALIZATION PARAMETERS 

Command ID: 0x43 Command ID: 0x43 





1 1 I-►RESERVED 

I I-►MEMORY TYPE 

I -►RESERVED 

Memory/Transfer/Address Modifier For Dump Initialization Parameters Command 


Bits 0-7 Address Modifier: 


This byte must be cleared for the Dump Initialization Parameters command. 


Bits 8-9 Memory Type: 

The only valid entry in this 2-bit field is 0x3, indicating that the data for this command is located in 
Short I/O, 


BITS 

BITS 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

(RESERVED) 

1 

0 

(RESERVED) 

1 

1 

Data is contained in Short I/O 


Memory Type (MT) Field For Dump Initialization Parameters Command 


Bits 10-11 Transfer Type: 

These bits must be cleared to 0. 

Bits 12-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Buffer Address (4 Bytes) 

This field specifies the offset into Short I/O in Host Usable Space at which the board is to start writing 
the initialization parameter list. 
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DUMP INITIAUZATION PARAMETERS DUMP INITIALIZATION PARAMETERS 

Command ID: 0x43 Command ID: 0x43 
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Buffer Address For Dump Initialization Parameters Command 


Maxunum Tranter Length (4 Bytes) 

This field specifies the maximum number of bytes that may be transferred by the command. 
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Maximum Transfer Length For Dump Initialization Parameters Command 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Dump Initialization Parameters command: 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value Indicates an error 
code. Appendix C contains the error codes. 

The board also writes the Initialization Parameters Block to the section of Short I/O specified by the 
host, as discussed below. 
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Command Set 


DUMP INITIALIZATION PARAMETERS DUMP INITIAUZATION PARAMETERS 

Command ID: 0x43 Command ID: 0x43 


Initialization Parameters Block 

When it executes the Dump Initialization Parameters command, the board writes the parameter list into 
Short I/O, starting at the offset provided in the Buffer Address field of the lOPB. 

The parameter list, which has the same format as the Controller Initialization Block. For an explanation 
of the fields in the Initialization Parameters Block, please refer to the Controller Initialization Block (Figure 
5-7). 
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DUMP WORK QUEUE PARAMETERS DUMP WORK QUEUE PARAMETERS 

Command ID: 0x44 Command ID: 0x44 


The Dump Work Queue Parameters command causes the board to report the current parameters of an 
individual work queue to the host. The host provides the work queue number. Note that a work queue 
must be initialized before its parameters can be dumped. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the IQPB for the Dump Work Queue Parameters command is shown below: 



NOTES: Fields set in bold letters are returned values. All other values are host provided. Resen/ed fields must be 
cleared to 0 by the host 


Figure 5-11 Dump Work Queue Parameter lOPB 


The remainder of this section describes the function of each field In the Dump Work Queue Parameters 
lOPB. 
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DUMP WORK QUEUE PARAMETERS DUMP WORK QUEUE PARAMETERS 

Command ID: 0x44 Command ID: 0x44 


Host-Provided lOPB Fields 

The following infomnation must be provided in the lOPB for the Dump Work Queue Parameters command: 

Command Code (2 Byt^) 

This field must be set to 0x44 to execute the Dump Work Queue Parameters command. 


Commcmd Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 
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Command Options For Dump Work Queue Parameters Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal {Completion Vector/Error Completum Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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Normal/Error Completion For Dump Work Queue Parameters 
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5 -^- 

DUMP WORK QUEUE PARAMETERS DUMP WORK QUEUE PARAMETERS 

Command ID: 0x44 Command ID: 0x44 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Intemipt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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Interrupt Level For Dump Work Queue Parameters 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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DUMP WORK QUEUE PARAMETERS DUMP WORK QUEUE PARAMETERS 

Command ID: 0x44 Command ID: 0x44 


W Work Queue Number (2 Bytes) 


This value may range from 0x1-0xE (work queues 1-14) for the Cougar II, and from Oxl-Oxff (work 
queues 1-255) for the Cougar 11 Wide. If an uninitialized work queue is specified, the command will 
complete with an illegal parameter status. 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Dump Work Queue Parameters command: 

Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 


WirHc Queue Options (2 Bytes^ 

This field contains the work queue options specified by the host when it initialized the work queue. 


Number Of Work Queue Slots (2 Bytes) 

This field contains the number of work queue slots specified by the host when it initialized the work 
queue. 


Command Timeout (4 Bytes) 

This field contains the command timeout specified by the host when it Initialized the work queue. 
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BUS STATUS INQUIRY BUS STATUS INQUIRY 

Command ID: 0x45 Command ID: 0x45 


The Bus Status Inquiry command returns the command tag of any lOPB currently executing on the selected 
SCSI bus. In addition, it returns the command tags of any in-progress lOPBs. An in-progress lOPB is one 
which has been sent to a device but is not completed yet. Information in the returned lOPB can be used 
to identify which lOPB and device is causing an error condition. 

During execution of this command, the board will stop all internal operations so that the response will reflect 
the state of the board at the time the Bus Status inquiry lOPB is executed. 

This command must be issued through the Master Command Entry to Work Queue 0. 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Note that word OxF in 
the above lOPB is issued with a host-provided value, but returned with a board-provided value. Reserved 
fields must be cleared to 0 by the host. 


Figure 5-12 Bus Status Inquiry lOPB 

The remainder of this section describes the function of each field In the Bus Status Inquiry lOPB. 
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BUS STATUS INQUIRY BUS STATUS INQUIRY 

Command ID; 0x45 Command ID: 0x45 


Host-Prcwided lOPB Fields 

The following information must be provided in the lOPB for the Bus Status Inquiry command: 


Conunfuid Code (2 Bytes) 

This field must be set to 0x45 to execute the Bus Status Inquiry command. 


Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 
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Command Options For Bus Status inquiry Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal Completion Vectar/Brror Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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Normal/Error Completion Vector For Bus Status Inquiry Command 
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BUS STATUS INQUIRY BUS STATUS INQUIRY 

Command ID: 0x45 Command ID: 0x45 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 


This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


« I I II II '' i r I I ' l l I I ir "— II I I " ' ll ' ' I I "T" II 1! II 
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I I-►INTERRUPT LEVEL 

I-- RESERVED 

Interrupt Level For Bus Status Inquiry Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete Interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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BUS STATUS INQUIRY BUS STATUS INQUIRY 

Command ID: 0x45 Command ID: 0x45 


Bus Selection (2 Bytes) 


This field specifies which SCSI bus is the subject of the Bus Status inquiry. 
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RESERVED 

BUS 

RESERVED 


Bus Selection For Bus Status Inquiry Command 


Bits 0-5 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 6 Bus: 

Clearing this bit selects the primary SCSI bus (Channel 0). Setting the bit selects the secondary SCSI 
bus (Channel 1). 

Bits 7-15 Reserved; 

These bits are reserved and must be cleared to 0 by the host. 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Bus Status Inquiry command: 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 


Active Command Tag (4 Bytes) 

The Active Command Tag field contains the command tag of a SCSI Pass-Through lOPB, if the 
command is being executed on the bus at the time that the Bus Status Inquiry is issued. 
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BUS STATUS INQUIRY BUS STATUS INQUIRY 

Command ID: 0x45 Command ID: 0x45 


Busy Ctmunand Tags 

The Busy Command Tags fields will contain any other currently "in-progress" lOPBs that may not be 
able to complete due to the "hung" active command. There can be up to seven busy commands per 
channel (words 0x8—0x9, OxA—OxB, OxC—OxD, OxE -OxF, 0x10—0x11, 0x12—0x13, 0x14—0x15). 

NOTE: The host-provided value in word OxF (Bus Selection) will be overwritten. 
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COMMAND STATUS INQUIRY COMMAND STATUS INQUIRY 

Command ID: 0x46 Command ID: 0x46 


The Command Status Inquiry lOPB returns the state of a previously issued lOPB based on the command 
tag field. If the lOPB specified by the command tag is active on the bus, Information will be returned 
to help identify the state of the SCSI activity. The board will suspend hardware operations until the 
status of the command is found and posted. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB is as follows: 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must 
be cleared to 0 by the host. 

Figure 5-13 Command Status Inquiry lOPB 


The remainder of this section describes the function of each field in the Command Status Inquiry lOPB. 
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COMMAND STATUS INQUIRY 

Command ID: 0x46 


COMMAND STATUS INQUIRY 

Command ID: 0x46 


Host-Provided JOPB Fields 

The following information must be provided in the lOPB for the Command Status Inquiry: 

Command Code (2 Bytesi 

This field must be set to 0x46 to execute the Command Status Inquiry command. 

Command Options (2 Bytesi 

This field contains the options for this command. The bits are defined as follows: 
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II .ill ■ II .1 i.ii iiUii—.i Jii ill.. .Ji I ill n II » .11 - ju i—n 

I_;_I I—►INTERRUPT ENABLE 

I-►RESERVED 


Command Options For Command Status Inquiry Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normid Completion Vector Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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I I-►ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Command Status Inquiry Command 
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COMMAND STATUS INQUIRY COMMAND STATUS INQUIRY 

Command ID; 0x46 Command ID: 0x46 


Bits 0>7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 

, I,. H P - ii -i II- i p. -ii—i — I I 'l l i r " HI ' H 'l l ■ r ii ' n " 'n i 
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n , II ■ ,»iiL- ..11-ill I ii ii n, it. , ii ii , [nJi 
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1 I-►INTERRUPT LEVEL 

I-- RESERVED 

Figure 3-45 Interrupt Level For Command Status Inquiry Command 

Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Command Tag (4 Bytes) 

This field specifies command tag of the lOPB. 
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COMMAND STATUS INQUIRY COMMAND STATUS INQUIRY 

Command ID: 0x46 Command ID: 0x46 
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Command Tag For Command Status Inquiry 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Command Status Inquiry: 


Return Status (2 Bytesi 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 


Command Status Code (2 Bytes) 

This field contains the returned command status. If the command Is active, additional information is 
returned in the next 2 fields: Last Command Issued and Phase Sense. 


Valid returned values for the Command Status Code are defined as follows: 


CODE 

EXPLANATION 

0x0001 

Command not found (command tag did not match) 

0x0002 

Command not in work queue (not executing yet) 

0x0003 

Command currently active (currently on SCSI bus) 

0x0004 

Command busy (currently disconnected) 

0x0005 

Command on Done Queue (The command is on the board's 
internal Done Queue and will have been received by the host 
before the response to the inquiry) 

0x0006 

Command in command queue (still in short I/O) 


Returned Values for Command Status Code 
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COMMAND STATUS INQUIRY COMMAND STATUS INQUIRY 

Command ID: 0x46 Command ID: 0x46 


Last Command Issued: 

This field indicates the last address given to the SCSI chip as a starting address. 

Phase Sense: 

This field indicates the current SCSI bus status. Valid returned values are shown below: 


BIT# 

EXPLANATION 

7 

Request 

6 

Acknowledge 

5 

Busy 

4 

Select 

3 

Attention 

2 

Message 

1 

Command/Data 

0 

Input/Output 


Returned Values in Phase Sense Field 
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READ/WRITE BUFFER READ/WRITE BUFFER 

Command ID: 0x47 Command ID: 0x47 


The Read/Write Buffer command provides compatibility for drivers and diagnostic routines that previously 
used the 4210 Jaguar Read/Write Buffer command. This command provides a mechanism to test the 
integrity of the DMA transfer mechanism of the board, without involving data transfers through the front end 
channel(s). This command must be issued through the Master Command Entry to work queue 0. The 
format of the lOPB is as follows: 



The remainder of this section describes the function of each field in the Read/Write Buffer lOPB. 

Host-Provided lOPB Fields 

The following Information must be provided in the lOPB for the Read/Write Buffer command: 
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Command Set 


READ/WRITE BUFFER READ/WRITE BUFFER 

Command ID: 0x47 Command ID: 0x47 


Comm€md Code 


The command code for this 10 PB is 0x47. 


w 


This field contains the options for this command. The bits are defined as follows: 



II. - I II , II I I I , | .i i . H i- i- 'i i- H i - » I ‘ I"" ! » 

-1 I i-n ' I 1 I '-1-' 1 . I 1-* INTERRUPT ENABLE 

1 I III I I '-►SCATTER/GATHER 

I I III I '-►SUPPRESS SYNCHRONOUS TRANSFERS 

I 1 III '-►RESERVED 

I I II I- ►SUPPRESS lOPB TIMEOUT 

I I I I-►RESERVED 

1 I I-►TRANSFER DIRECTION 

1 I-►RESERVED 

I-►ENABLE WIDE DATA TRANSFERS 

-►SCSI QUEUE TAG TYPE 


Command Options For Read/Write Buffer Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bit 8 VMEbus Transfer Direction: 

When this bit is set, data will be transferred from the host to the board. When this bit is cleared, data 
will be transferred from the board to the host. 

For a write to the VMEbus. the board will allocate and fill its local buffers with the amount of data 
specified. If sufficient buffers cannot be allocated, the lOPB will be returned with an error, and no 
data will be transferred. 

For a read from the VMEbus, the board will attempt to return data previously transferred via the write 
command. If less data has been written than requested by the read command, the data that exists 
will be transferred, and the lOPB returned with a Transfer Length Exception. 


N€jrm€il E>mr Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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READ/WRITE BUFFER READ/WRITE BUFFER 

Command ID: 0x47 Command ID: 0x47 
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I I-►ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Read/Write Buffer Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMBsus interrupt level used to notify the host of a command completion 
(normal or with error). 
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Interrupt Level For SCSI Pass-Through Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed with a level of 0 allowed only when interrupts are 
disabled by clearing the Interrupt enable bit in the Command Options word. 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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read/write buffer read/write buffer 

Command ID: 0x47 Command ID: 0x47 


VME Tranter Type (2 Bytes) 

This field specifies the address modifier, memory type, and transfer type to be used for all VMEbus 
transfers associated with the command. 

NOTE: As a slave, the board responds to either 0x2D and 0x29, or 0x2D VME address modifiers 
only. This depends on how the address modifier jumpers are set onboard. For a 
description of these jumpers, refer to chapter 2. As a master, the board will use whatever 
address modifier is in the lOPB. It Is not checked. Some memory systems may not support 
all of the options discussed for this field. 
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ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 
LINK 


VME Transfer Types For ReadAA/rite Buffer Command 


Bits 0-7 Address Modifier: 

This byte specifies the address modifier used by the board for ail VMEbus data transfers associated 
with this command. 

Bits 8-9 Memory Type: 

This 2-bit field specifies the width of the data transfers. Permitted values are shown below. 


BITS 

BITS 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

16-bit transfers 

1 

0 

32-bit transfers 
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READ/WRITE BUFFER READ/WRITE BUFFER 

Command ID: 0x47 Command ID: 0x47 


Bits 10-11 Transfer Type: 

This 2-bit field specifies the type of data transfer to be performed. Permitted values are shown below. 


BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL TYPE 

0 

1 

BLOCK MODE 

1 

0 

(RESERVED) 

1 

1 

VME D64 BLOCK 


Bits 12-14 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bijfffer Address (4 Byte^ 

This field specifies the address at which the board will begin the data transfer. If the board is 
addressing system memory, the value in the field is a VMEbus address. 



Maximum Transfer Length 

This field specifies the maximum number of bytes that may be transferred by the command. When 
multiple read and write commands are interspersed, the data stream will resemble a FIFO. No partial 
buffers will be written back; an error will be returned. 


Note: Consistent block sizes, in multiples of 2K bytes, should be used for both reads and writes. 
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READ/WRITE BUFFER READ/WRITE BUFFER 

Command ID: 0x47 Command ID: 0x47 


Returned V€dues 

Upon command completion, the following information is provided by the board in the returned lOPB of the 
command response for the SCSI Pass-Through command. 


Return Status (2 Bytes^ 

This field provides the return status for the command. 



I I-* ERROR CODE 

I ___-PASS-BACK STATUS 

Return Status For ReadA/Vrite Buffer Command 


Bits 0-7 Error Code: 

The Error Code byte describes the status of the controller at the end of the command response. Any 
non-zero value is an error code. Appendix C contains the error codes. 


POSSIBLE ERRORS 

0x19 

ILLEGAL lOPB PARAMETER 

COUNT IS NOT A MULTIPLE OF 

2K BYTES. OR MORE DATA WAS 
REQUESTED TO BE WRITTEN 

THAN COULD BE 

ACCOMMODATED BY THE 

BOARD’S INTERNAL BUFFER. 

0x20 

VMEbus BUS ERROR 

DATA CANNOT BE 

TRANSFERRED BACK TO THE 

HOST. THIS MAY LIKELY BE 
CAUSED BY REQUESTING A 

READ FOR WHICH NO WRITE 

HAS OCCURRED. 

0X34 

TRANSFER COUNT EXCEPTION 

INSUFFICIENT DATA EXISTS TO 
SATISFY A READ REQUEST. 
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READ/WRITE BUFFER 

Command ID: 0x47 


READ/WRITE BUFFER 

Command ID: 0x47 


OnbocurdL Buffer Address 

This field will contain the address of the first buffer that was returned. For requests larger than 2K. 
multiple, non-contiguous buffers will be used. 

Onboard Bifffer Count 

This field will contain the number of buffers used to satisfy the read or write request. 
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CANCEL COMMAND TAG CANCEL COMMAND TAG 

Command ID: 0x48 Command ID: 0x48 


The Cancel Command Tag lOPB cancels the execution of a previously issued lOPB, based on the 
command tag specified in the Cancel Command Tag lOPB. Issuing the command causes the board to find 
and cancel the //rsf command tag that matches the one given in the lOPB. If multiple lOPBs exist with the 
same command tag, only the first one found will be canceled. If the board Is unable to locate a command 
whose tag matches the one in the lOPB, it will return the Cancel Command Tag lOPB with an error. 

This command must be Issued through the Master Command Entry to Work Queue 0. 

If an lOPB is canceled and subsequent SCSI activity attempts to complete the command, the board will 
return a controller error indicating that a device has connected for which there is no lOPB. 

NOTE: Use of this command implies that the host uses unique command tags for all lOPBs on the board. 

The format of the Cancel Command Tag lOPB is shown below. 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must be 
cleared to 0 by the host. 


Figure 5-15 Cancel Command Tag lOPB 


The remainder of this section describes the function of each field in the Cancel Command Tag iOPB. 
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CANCEL COMMAND TAG CANCEL COMMAND TAG 

Command ID: 0x48 Command ID: 0x48 


Htfst-Provided lOPB Fields 

The following information must be provided in the lOPB for the Cancel Command Tag command: 


Command Code (2 Bytes) 

This field must be set to 0x48 to execute the Cancel Command Tag command 

Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 


i 15 i 14 ii 13 li 12 j 11 I 10 J 9 i 8 S 7 i 6 I 5 i 4 i 3 i 2 i 1 i 0 i 
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I--1 1—►interrupt enable 

I-- RESERVED 


Command Options For Cancel Command Tag Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal {Completion Vectar/Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


II 15 li 14 il 13 II 12 ii 11 i 10 i| 9 It 8 il 7 li 6 II 5 II 4 i 3 R 2 li 1 ii 0 « 
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i I-►ERROR COMPLETION VECTOR 

<-.NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Cancel Command Tag Command 
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CANCEL COMMAND TAG 

Command ID: 0x48 


CANCEL COMMAND TAG 

Command ID: 0x48 


Bits 0-7 Error Completion Vector: 

This value specifies the intenupt vector used when notifying the host of command completion 
with error. 

Bits 8-15 Normal Completion Vecton 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


II II I I II II II II II II u II II I I II ~ ir II II 
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I-,-1 I-,-1 

I I-►INTERRUPT LEVEL 

I-►RESERVED 


Interrupt Level For Cancel Command Tag Command 


Bits 0-2 interrupt Level (LVL): 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on 
the VMEbus. Values of 0 through 7 are allowed, but a level of 0 Is allowed only when interrupts 
are disabled (Interrupt Enable bit = 0 In the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Command Tag (4 Bytes) 

This field specifies command tag of the lOPB to be canceled. 
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CANCEL COMMAND TAG CANCEL COMMAND TAG 

Command ID: 0x48 Command ID: 0x48 
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Command Tag For Cancel Command Tag Command 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB 
for the Cancel Command Tag command: 


Return Status (2 Bytes^ 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. Appendix C contains the error codes. 
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Return Status For Cancel Command Tag 
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FLUSH WORK QUEUE FLUSH WORK QUEUE 

Command ID: 0x49 Command ID: 0x49 


The Flush Work Queue command flushes ail commands that have been placed in the work queue, as well 
as any commands in the Command Queue destined for the work queue. This command flushes only the 
specified work queue and, optionally will report completion of each entry in the queue. 

This command must be issued through the Master Command Entry to Work Queue 0. 

At the completion of the Rush Work Queue command, the number of entries flushed from the queue will 
be returned. The returned lOPB will also report whether any commands were "In Progress" when the 
Flush Work Queue command was executed. 

If any of the flushed commands are "In Progress" , it may be necessary to reset the SCSI bus in order 
to clear the effects of the command with respect to the target. To do so, issue a Reset SCSI Bus lOPB. 

The format of the lOPB is as follows: 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must be cleared 
to 0 by the host 


Figure 5-16 Flush Work Queue lOPB 


The remainder of this section describes the function of each field in the Flush Work Queue lOPB. 
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FLUSH WORK QUEUE FLUSH WORK QUEUE 

Command ID: 0x49 Command ID: 0x49 


Host-Provided IGPB Fields 

The following information must be provided in the lOPB for the Flush Work Queue command: 


Ctnrunand Code (2 Bytes) 

This field must be set to 0x49 to execute the Flush Work Queue command. 

Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 


i 15 I 14 ij 13 I 12 I 11 i 10 i 9 i 8 ii 7 i 6 j 5 j 4 i 3 j 2 I 1 j 0 S 

" _ " '■ ■■ '■ " " . . " ” ” " '* ” 

I-,-1 1 i-,-1 I—INTERRUPT ENABLE 

I I I -►RESERVED 

I I-►REPORT FLUSHED COMMANDS 

«-►RESERVED 

Figure 3-49 Command Options For Rush Work Queue Command 
Bit 0 Interrupt Enable : 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. Note that it is not necessary to enable this bit in order to 
report flushed commands. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 8 Report Flushed Commands: 

Setting this bit causes the board to report each command as it is flushed with a Command Complete 
Interrupt and an Error Status. Clearing the bit disables this function. 

NOTE: Only the commands that have the Interrupt Enable bit set in the Command Options word of 
their individual lOPBs will generate an interrupt as they are flushed. 

Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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FLUSH WORK QUEUE 

Command ID: 0x49 


FLUSH WORK QUEUE 

Command ID: 0x49 


Work Queue Number (2 Bytes) 

This is the number of the work queue to be flushed. 


NarmtMl Completion Vector/Brror Completion Vector (2 Bytes) 


These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with eiror. 


II 15 II 14 ii 13 II 12 II 11 B 10 II 9 n 8 « 7 il 6 II 5 I 4 I 3 H 2 II 1 II 0 II 
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ERROR COMPLETION VECTOR 
NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Flush Work Queue Command 


Bits 0-7 Error Completion Vector 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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Interrupt Level For Flush Work Queue Command 
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FLUSH WORK QUEUE FLUSH WORK QUEUE 

Command ID: 0x49 Command ID: 0x49 


Bits 0-2 interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB 
for the Flush Work Queue command: 


Return Status (2 Bytes^ 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains error codes. 


Number Of Citmmtinds Ftushed/In Progress (2 Bytes) 


n-II II-:i 'i-II II 
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NUMBER OF COMMANDS FLUSHED 
PRIMARY BUS COMMAND IN PROGRESS 
SECONDARY BUS COMMAND IN PROGRESS 


Commands Flushed In Progress Commands 


Bits 0-13 Numbers of Entries Flushed: 

This is the number of entries that were flushed from the work queue. 

Bit 14 Primary Bus (Channel 0) Command In Progress: 

The board sets this bit in the returned lOPB when an In-Progress command is present on the 
primary SCSI bus. There can never be more than one In-Progress command for any one work 
queue, but because the SCSI bus allows targets to disconnect, there can be multiple In-Progress 
commands on each SCSI bus. 
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Command Set 


FLUSH WORK QUEUE FLUSH WORK QUEUE 

Command ID: 0x49 Command ID: 0x49 


Bit 15 Secondary Bus (Channel 1) Command In Progress: 

The board sets this bit in the returned lOPB when an In-Progress command is present on the 
secondary SCSI bus. 
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5 -- 

INITIALIZE PRINTER PORT INITIALIZE PRINTER PORT 

Command ID: 0x4A Command ID: 0x4A 


The Initialize Printer Port command is used to configure the printer port for the interface being used 
(Dataproducts or Centronics), in addition, it enables/disables status change interrupts. 

The Initialize Printer Port command can be issued at any time to reset the printer port. The command is 
issued with the reset bit set to clear the printer port hardware, it should never be necessary to reset the 
hardware. 

The command may also be issued at any time to assert a buffer clear to the printer. Since the time 
required for holding this signal varies from printer to printer, the board will leave the line set until the host 
issues another Initialize Printer Port command with the bit cleared. 

NOTE: The vector used for status change interrupts is stored in word 0x2 of the Controller Initialization 
Block (the lower byte of the Controller Normal Completion Level/Vector field). 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the Initialize Printer Port lOPB is as follows: 



NOTES; Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must be 
cleared to 0 by the host. 


Figure 5-17 Initialize Printer Port lOPB 


The remainder of this section describes the function of each field in the Initialize Printer Port lOPB. 
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Commcuid Set 


INITIALIZE PRINTER PORT INITIALIZE PRINTER PORT 

Command ID: 0x4A Command ID: 0x4A 


Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Initialize Printer Port command: 


C€munand Code (2 Bytes) 

This field must be set to 0x4A to execute the Initialize Printer Port command. 


Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 


II 15 « IM 13 II 12 B n « 10 II 9 II 8 II 7 5 6 il 5 II 4 11 3 

“ . ■■ " '' " " " " ■■ ■' " '■ “ - 


0 II 


L—INTERRUPT ENABLE 
—►RESERVED 


Command Options For Initialize Printer Port Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal Completion Vector/Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


ir T" II II "’ ll 

4 II 3 II 2 11 1 B 0 II 

" " " ” . " 


► ERROR COMPLETION VECTOR 

► NORMAL COMPLETION VECTOR 


15 


14 


13 i 12 i 11 

» " 


10 B 9 II 8 II 7 

» " “ I 


Normal/Error Completion Vector For Initialize Printer Port 
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- 5 -- 

INITIALIZE PRINTER PORT INITIALIZE PRINTER PORT 

Command ID: 0x4A Command ID: 0x4A 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


ii 151 14 i 13 i 12 j 11 i 10 ii 9 i 8«716 i 5 i 4 i 3 i 2 i 1 j 0 ii 

» I » " '■ " ■' " " » ” " » " , " . “ “ ; • " 

I__ < (_,_i 

1 I-.INTERRUPT ENABLE 

I__ RESERVED 


Interrupt Level For Initialize Printer Port Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete Interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 In the Command Options word). 

Bits 3-15 Reserved: 

These bits are resen/ed and must be cleared to 0 by the host. 


Printer Options (2 Bytes) 

The field the available options for the command: 
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Command Set 


INITIALIZE PRINTER PORT INITIALIZE PRINTER PORT 

Command ID: 0x4A Command ID: 0x4A 


II 15 H U 8 13 fl 12 II n B 10 II 9 II 8 II H 6 » 5 I 4 II 3 M 2 II 1 I 0 I 

" I II I » 1 “ - I -i ' -r " T-ii---- 

I I I '-1-' '-1-' 

III 1 I-►STATUS CHANGE INTERRUPT ENABLE 

I I I I-►RESERVED 

I I I-►BUFFER CLEAR/PRINTER INIT 

I I-►ODD/EVEN 

I-►RESET 

Printer Options For Initialize Printer Port Command 


Bits 0>7 Status Change Interrupt Enable: 

This field is used to enable interrupts from the printer status lines which the host is to monitor. To 
enable a specific status line, set the appropriate bit. The field’s bit definitions vary depending the 
printer type, as listed below: 


Dataproducts Printers: 

Centronics Printers: 

Bit 7 - Reserved • 0 ' 

Bit 7 - Reserved • 0 

Bit 6 • Reserved • 0 

Bit 6 • Resen/ed - 0 

Bit 5 - Resen/ed • 0 

Bit 5 - Reserved • 0 

Bit 4 • Reserved • 0 

Bit 4 - Resen/ed • 0 

Bit 3 ' Cable On 

Bit 3 • Resen/ed • 0 

Bit 2 - Parity Error 

Bit 2 - Paper Empty 

Bit 1 • Online 

Bit 1 - Select 

Bit 0 - Ready 

Bit 0 - Fault 


NOTE: These signals are active high. 

Printer Status Change Interrupt Field 


Bits 8-12 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 13 Buffer Clear/Printer Init: 

Issuing the Initialize Printer Port command with this bit set causes the board to assert a Buffer Clear 
to a Dataproducts printer or a Print Init to a Centronics printer. 

NOTE: After using Bit 13 to issue a Buffer Clear/Print Init instruction, the host must issue another 
Initialize Printer Port command with this bit cleared to return to norma! printer operations. 
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5 - 

INITIALIZE PRINTER PORT INITIALIZE PRINTER PORT 

Command ID; 0x4A Command ID: 0x4A 


Bit 14 Odd/Even: 

This bit applies to Dataproducts printers only. It specifies the parity polarity, as follows: 

0 s Even Parity 
1 = Odd Parity 

Bit 15 Reset: 

Setting this bit set causes the board to reset the printer port. The port will be ready to receive new 
print commands after the completion status has been returned to the host. 


Returned Values 

Upon command completion, the following Information is provided by the board in the returned lOPB, of the 
command response, for the initialize Printer Port command: 


Return Status (2 Byte^ 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 
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Commcuid Set 


RESTART CONTROLLER 

Command ID: 0x4B 


RESTART CONTROLLER 

Command ID: 0x4B 


The Restart Controller command provides a method of resetting the controller and bypassing the power-up 
diagnostics. This command is analogous to a soft reset that tells the board to clear all current operations. 

The first action the board takes is to reset the SCSI ports. It then flushes all internal commands, with the 
exception of the Restart Controller command. Next, the Command Queue pointer is reset to the base of 
the Command Queue. Finally, the Restart Controller command completion is returned to the Command 
Response Block. All Controller Initialization Block and work queue parameters remain intact. The host is 
responsible for resulting its Command Queue pointers. 

This command must be issued through the Master Comn^nd Entry to Work Queue 0. 

NOTE: It may be necessary for the host to issue a Request Sense to on-line devices after executing the 
Restart Controller command. This depends on what the devices require after a SCSI bus reset. Consult 
your device manuals for details. 

The format of the Restart Controller lOPB is as follows: 


WORD # 

15 14 1 13 1 12 1 11 1 10 9 8 

B 

B 

1 

B 

0x0 

COMMAND CODE (0x4B) 

0x1 

COMMAND OPTIONS 

0x2 

RETURN STATUS 

0x3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

0x5 

INTERRUPT LEVEL 

0x6 

To 

0x15 

RESERVED 


NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must be 
cleared to 0 by the host 

Figure 5-18 Restart Controller lOPB 


The remainder of this section describes the function of each field in the Restart Controller lOPB. 











































Chapter 


RESTART CONTROLLER 

Command ID: 0x4B 


RESTART CONTROLLER 

Command ID: 0x4B 



Host-Pramded lOPB Fields 

The following information must be provided in the lOPB for the Restart Controller command: 


Ckmunand Code (2 BytesH 

This field must be set to 0x4B to execute the Restart Controller command. 


Command Options (2 Byte^ 

This field contains the options for this command. The bits are defined as follows: 


I I .I I . II II " II "" IT ■■■ " IT " ■![ - - ir—I f" I I 'll ■ ■ ir — " 'l l 
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" I '■ " » ■■ " " " ■■ H I -» II -H ll_ <1 

<-,-1 I—INTERRUPT ENABLE 

I-- RESERVED 

Command Options For Restart Controller Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal Completion VectorflSrrar Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


I 15 B 14 B 13 B 12 B 11 II 10 i| 9 B 8 B 7 I 6 B 5 I 4 ii 3 II 2 !1 1 II 0 II 

|‘—[—- " " '' '■ - " , " , " “ ” “ " ' ” 1 '' 


ERROR COMPLETION VECTOR 
NORMAL COMPLETION VECTOR 


Normal/Error Completion for Restart Controller Command 
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Command Set 


RESTART CONTROLLER RESTART CONTROLLER 

Command ID: 0x4B Command ID: 0x4B 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


H II "T I I II II■ y- II » ' r II I I u I I " -1^ 

II 15 B 14 I 13 II 12 II 11 « 10 fl 9 I 8 g 7 B 6 8 5 I 4 8 3 I! 2 J 1 R 0 « 

» , " '■ " '■ ■■ It n K B H It ^ I. n ^ II 


I I-►INTERRUPT LEVEL 

I-►RESERVED 

Interrupt Level For Restart Controller Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the Jaguar to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Returned Values 

Upon command completion, the following information is provided by the board in the returned 10PB of the 
command response, for the Restart Controller command: 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains error codes. 
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5 -- 

DEVICE REINITIALIZE DEVICE REINITIALIZE 

Command ID: 0x4C Command ID; 0x4C 


The Device Reinitialize command clears the first connection (synchronous negotiation state) of a device. 
This causes the board to re-negotiate the synchronous transfer rate on the next selection to the target. 
This command is only necessary when a device has been disconnected from the bus or power removed 
from a device. 


The format of the Device Reinitialize lOPB is as follows: 


WORD* 

IS 

B 

1 

3 

1 11 

2 1 

10 

9 

8 

BBB 


3 1 2 i 1 

B 

0x0 

COMMAND CODE <0x4C) 

0x1 

COMMAND OPTIONS 

0X2 

RETURN STATUS 

0x3 

RESERVED 

0x4 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

OXS 

INTERRUPT LEVEL 


RESERVED 

II__ 

UNIT ADDRESS 


RESERVED 


NOTES: Fields set in t>old capitat letters are returned values. AH other values are host provided. Reserved tields must be cleared to 0 by 
the host. 

Rgure 5-19 Device Reinitialize lOPB 

The remainder of this section describes the function of each field In the Device Reinitialize lOPB. 

Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Device Reinitialize command: 

Command Code (2 Bytes) 

This field must be set to 0x4C to execute the Device Reinitialize command. 
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Command Set 


DEVICE REINITIALIZE 

Command ID: 0x4C 


DEVICE REINITIALIZE 

Command ID: 0x4C 


Command Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 


II II ' II ' . ' I " ’ l l" ' i T ~ " I I ■ ■■ II II ' l l " I I " I I ir ~ ii II I I I I 
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I - 1 - 1 i_* interrupt enable 

I-- RESERVED 

Command Options For Device Reinitialize Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to Interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Normal Campletian Vector/Eirror Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


i 15 8 14 j 13 i 12 8 11 8 10 8 9 i 8 8 7 i 6 j 5 i 4 ii 3 i 2 i 1 8 0 j 

» j - “.-'■ « '■ " " , ” , “ " '' " .. I ■“ 


TERROR COMPLETION VECTOR 
^NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Device Reinitialize Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the Interrupt vector used when notifying the host that the command completed 
without error. 
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5 -- 

DEVICE REINITIALIZE DEVICE REINITIALIZE 

Command ID: 0x4C Command ID: 0x4C 


Interrupt Level (2 Bytes) 


This field specifies the VMEbus intemipt level used to notify the host of a command completion 
(normal or with error). 
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I I-►INTERRUPT LEVEL 

I-►RESERVED 


Interrupt Level For Device Reinitialize Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Unit Address (2 Bytes) 


This field specifies the SCSI bus and the address of the target device. 


II II 

B 15 H 14 

« '' 


11 II' " 'll II II II I I I I II I I I I II "" -r "" —n 

13 II 12 B 11 B 10 B 9 I 8 B 7 B 6 « 5 a 4 fi 3 B 2 B 1 II 0 B 
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I III '-►SCSI DEVICE ID 

I I I I-►LUN 

I I I-►SCSI BUS SELECTION 

I I -►EXTENDED ADDRESS ENABLE (0) 

I-—--- RESERVED 


Unit Address For Device Reinitialize Command 


Bits 0-2 SCSI Device iD (SCSI ID): 

These bits contain the SCSI ID that is used when addressing the target. This value may range from 
Oto 7. 
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Cktmmand Set 


DEVICE REINITIALIZE DEVICE REINITIALIZE 

Command ID: 0x4C Command ID: 0x4C 


Bits 3-5 Logical Unit Number (LUN): 

The SCSI Logical Unit Number will be defined in these three bits. Refer to American National 
Standard Institute X3.131-199X for a detailed description of Logical Unit Numbers. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the board uses when 
executing the command. When the BUS bit is cleared to 0, the board executes the command over 
the primary SCSI bus (Port 0). When set to 1. it uses the secondary SCSI bus (Port 1). 


Bit 7: Extended Address Enable 

Normal addressing is used when this bit is set to zero. Extended addressing is enabled when this 
bit is set to 1. 

Bits 8-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NOTE: When bit 7 is cleared bits 8-15 are reserved. 


Extended Unit Address (2 Bytesi 


This field specifies the SCSI bus and the address of the target device. 


II II ll II II II " II II II 

8 15 I 14 I 13 » 12 « 11 I 10 I 9 I 8 I 7 I 

II f. II I. II ii 11 . 1-1 11 |l^ll I II 


6ii5|i4ii3ii2iii!oi 

" '■ » " •• II 


L 


SCSI DEVICE ID 

RESERVED 

SCSI BUS SELECTION 

EXTENDED ADDRESS ENABLE (1) 

EXTENDED LUN 

RESERVED 


Extended Unit Address For Device Reinitialize Command 


Bits 0-4 SCSI Device ID (SCSI ID): 

These bits contain the SCSI ID that is used when addressing the target. This value may range from 
0 to 31. 
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5 -^- 

DEVICE REINITIALIZE DEVICE REINITIALIZE 

Command ID: 0x4C Command ID: 0x4C 


Bit 5 Reserved: 

This bit is reserved and must be set to zero by the host. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the board uses when 
executing the command. When the BUS bit is cleared to 0, the board executes the command over 
the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI bus (Port 1). 

Bit 7 Extended Address Enable: 

Setting this bit enables the extensions to both the LUN’s and the SCSI ID. When this bit is set (1), 
the SCSI device ID shall be extended by two bits into the old LUN field. Bits 0-4 will now be utilized 
for the SCSI device ID. 

Bits 8-13 Extended LUN (EXT LUN): 

The LUN will be taken from the 6 bit field Extended LUN. 

Bits 14-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Device Reinitialize command: 


Return Status (2 Byte^ 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 
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4 II 3 
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> ERROR CODE 


Return Status For Device Reinitialize 
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Command Set 


ISSUE BUS DEVICE RESET MESSAGE ISSUE BUS DEVICE RESET MESSAGE 

Command ID; 0x4D Command ID; 0x4D 


The Issue Bus Device Reset Message command causes the board to issue a SCSI Bus Device Reset 
message to the selected SCSI device. This command enables the host to reset individual devices on the 
bus. The host should issue this command after insuring that no commands are currently being executed 
on this device. The Bus Device Reset message is sent from the initiator to direct a target to clear all 
current commands on a SCSI device. This message forces the SCSI device to an initial state with no 
operations pending for any initiator. Upon recognizing this message, the target goes to the Bus Free 
phase. The device must be able to respond to selection and receive message bytes. 

This command must be issued through the Master Command Entry to Work Queue 0. 

Note: It may be necessary for the host to issue a Request Sense to on-line devices after executing an 
Issue Bus Device Reset Message lOPB. This depends on what the devices require after a SCSI bus reset. 
Consult your device manuals for details. 

The format of the lOPB is as follows; 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must be 
cleared to 0 by the host 


Figure 5-20 Issue Bus Device Reset Message lOPB 


The remainder of this section describes the function of each field in the Issue Bus Device Reset Message 
lOPB. 
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5 -- 

ISSUE BUS DEVICE RESET MESSAGE ISSUE BUS DEVICE RESET MESSAGE 

Command ID; 0x4D Command ID: 0x4D 


Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Issue Bus Device Reset Message 
command: 

Ctmunand Code (2 Bytes) 

This field must be set to 0x4D to execute the Issue Bus Device Reset Message command. 

Ctmunand Options (2 Bytes) 

This field contains the options for this command. The bits are defined as follows: 


15 I 14 I 13 


12 II 11 B 10 i 9 I 8 ( 7 I 6 i 5 
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4 I 3 fl 2 J 1 II 0 


i—INTERRUPT ENABLE 
—►RESERVED 


Command Options For Issue Bus Device Reset Message Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete intenupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Normal Completion VectariEnror Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 


II 15 B 14 H 13 II 12 II 11 II 10 i 9 I 8 II 7 n 6 II 5 II 4 II 3 II 2 II 1 II 0 II 
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ERROR COMPLETION VECTOR 
NORMAL COMPLETION VECTOR 


Normal/Error Completion For Issue Bus Device Message 
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Command Set 


ISSUE BUS DEVICE RESET MESSAGE ISSUE BUS DEVICE RESET MESSAGE 

Command ID: 0x4D Command ID: 0x4D 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bptesd 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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I I-►INTERRUPT LEVEL 

I-►RESERVED 

interrupt Level For Issue Bus Reset Message Command 


Bits 0-2 interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 Is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 In the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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ISSUE BUS DEVICE RESET MESSAGE ISSUE BUS DEVICE RESET MESSAGE 

Command ID: 0x4D Command ID: 0x4D 


Unit Address (2 Bytes) 


This field specifies the SCSI bus and the address of the target device. 


i 15 i 14 i 13 
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12 II 11 II 10 II 9 II 8 I 7 H 6 I 5 
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I I 


SCSI DEVICE ID 
LUN 

SCSI BUS SELECTION 
EXTENDED ADDRESS ENABLE = 0 
RESERVED 


Unit Address For issue Bus Device Reset Message Command 


Bits 0-2 SCSI Device iD (SCSI ID): 

These bits contain the SCSI ID that is used when addressing the target. This value may range from 
0to7. 

Bits 3-S Logical Unit Number (LUN): 

The SCSI Logical Unit Number will be defined in these three bits. Refer to American National 
Standard Institute X3.131-199X for a detailed description of Logical Unit Numbers. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the board uses when 
executing the command. When the BUS bit is cleared to 0. the board executes the command over 
the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI bus (Port 1). 

Bit 7: Extended Address Enable 

Normal addressing is used when this bit is set to zero. 

Bits 8-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NOTE: When bit 7 is cleared bits 8-15 are reserved. 
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ISSUE BUS DEVICE RESET MESSAGE ISSUE BUS DEVICE RESET MESSAGE 

Command ID: 0x4D Command ID: 0x4D 


W Elxtended Unit Address (2 Bytes) 

This field specifies the SCSI bus and the address of the target device. 



SCSI DEVICE ID 

RESERVED 

SCSI BUS SELECTION 

EXTENDED ADDRESS ENABLE 

EXTENDED LUN 

RESERVED 


( 1 ) 


Extended Unit Address For SCSI Target Device 


Bits 0-4 SCSI Device iD (SCSi iD): 

These bits contain the SCSI. ID that is used when addressing the target. This value may range from 
0to31. 

Bit 5 Reserved: 

This bit is reserved and must be set to zero by the host. 

Bit 6 SCSi Bus Seiection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the board uses when 
executing the command. When the BUS bit is cleared to 0, the board executes the command over 
the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI bus (Port 1). 

Bit 7 Extended Address Enabie: 

Setting this bit enables the extensions to both the LUN’s and the SCSI ID. When this bit Is set (1), 
the SCSI device ID shall be extended by two bits into the old LUN field. Bits 0-4 will now be utilized 
for the SCSI device ID. 

Bits 8-13 Extended LUN (EXT LUN): 

The LUN will be taken from the 6 bit field Extended LUN. 

Bits 14-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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ISSUE BUS DEVICE RESET MESSAGE ISSUE BUS DEVICE RESET MESSAGE 

Command ID: 0x4D Command ID: 0x4D 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
issue Bus Device Reset Message command: 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 
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I-►ERROR CODE 

Return Status For Device Reset 
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ISSUE ABORT MESSAGE ISSUE ABORT MESSAGE 

Command ID: 0x4E Command ID: 0x4E 


Issue Abort Message command causes the board to issue a SCSI Abort message to the selected SCSI 
device. An Abort message is sent from the initiator to direct a target to clear the present operation. If a 
logical unit has been identified, all pending status for this initiator is cleared from the affected logical unit, 
and the target goes to the Bus Free phase. Pending data and status for other initiators is not cleared. If 
a logical unit has not been identified, the target goes to the Bus Free phase. No status or ending message 
is sent for the operation. 

It is not an error to issue this message to a logical unit that is not currently performing an operation for the 
initiator. This command can be used to terminate an operation that is no longer required (killing a Format 
command to a drive, for example). 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the Issue Abort Message lOPB is as follows: 



NOTES: Fields set in bold capital letters are returned values. All other values are host provided. Reserved fields must be 
cleared to 0 by the host 


Figure 5-21 Issue Abort Message lOPB 

The remainder of this section describes the function of each field in the Issue Abort Message lOPB. 
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ISSUE ABORT MESSAGE ISSUE ABORT MESSAGE 

Command ID; 0x4E Command ID: 0x4E 


Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Issue Abort Message command: 


Command Code (2 Bytesi 

This field must be set to 0x4E to execute the Issue ^ort Message command. 


Command Options (2 Bytesi 

This field contains the options for this command. The bits are defined as follows: 


ii i. ■■ || M - I , ■ n, . „ „ i D I. 1,1. i-„ . -ii|p I , II I. II ' i r -n i 

I 15 I 14 « 13 I 12 « 11 II 10 II 9 I 8 i 7 I 6 i 5 I 4 I 3 B 2 I 1 B 0 II 

" , ■■ » ■■ - “ - " ” - M _JL II II. II II. -Jl 

I_,_I i-*INTERRUPT ENABLE 

I-►RESERVED 

Command Options For Issue Abort Message Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to interrupt the host upon command completion. Clearing the bit 
disables the Command Complete interrupt. 


Bits 1-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host. 


Normal Campletian Vectar/Errar (Unnpletian Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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1 I-►ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 

Normal/Error Completion For Issue Abort Message 
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ISSUE ABORT MESSAGE ISSUE ABORT MESSAGE 

Command ID: 0x4E Command ID: 0x4E 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 


I 15 j 14 ii 13 ii 12 ii 11 i 10 ii 9 » 8 ii 7 ii 6 j 5 ii 4 i 3 ii 2 ii 1 ii 0 
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►INTERRUPT LEVEL 
►RESERVED 


Interrupt Level For Issue Abort Message Command 


Bits 0-2 Interrupt Level: 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


Unit Address (2 Bytes) 

This field specifies the SCSI bus and the address of the target device. 
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ISSUE ABORT MESSAGE ISSUE ABORT MESSAGE 

Command ID: 0x4E Command ID: 0x4E 


I ? -'—I f" " I! ' 'i r"" ir' .i i■'ii ' " ii '■ ir "w i i"' i i '"ni~i i 
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I III '-►SCSI DEVICE ID 

I 1 I I-.LUN 

I I I-*SCSI BUS SELECTION 

I I-►EXTENDED ADDRESS ENABLE (0) 

I-►RESERVED 

Unit Address For Issue Abort Message Command 


Bits 0-2 SCSI Device ID (SCSI ID): 

These bits contain the SCSI ID that is used when addressing the target. This value may range from 
0to7. 

Bits 3-5 Logical Unit Number (LUN): 

The SCSI Logical Unit Number will be defined in these three bits. Refer to American National 
Standard Institute X3.131-199X for a detailed description of Logical Unit Numbers. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the board uses when 
executing the command. When the BUS bit is cleared to 0, the board executes the command over 
the primary SCSI bus (Port 0). When set to 1, It uses the secondary SCSI bus (Port 1). 

Bit 7 Extended Address Enable: 

Normal addressing is used when this bit is set to zero. 

Bits 8-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

NOTE: When bit 7 Is cleared bits 8-15 are reserved. 


Extended Unit Address (2 Bytes) 

This field specifies the SCSI bus and the address of the target device. 
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ISSUE ABORT MESSAGE 

Command ID: 0x4E 


ISSUE ABORT MESSAGE 

Command ID: 0x4E 


15 II 14 B 13 « 12 « 11 M 10 II 9 II 8 B 7 B 6 H 5 II 4 It 3 I 2 II 1 II 0 II 


I I I 
I I I 


►SCSI DEVICE ID 

►RESERVED 

►SCSI BUS SELECTION 

► EXTENDED ADDRESS ENABLE (1) 

► EXTENDED LUN 
►RESERVED 


Extended Unit Address For Issue Abort Message Command 


Bits 0>4 SCSI Device ID (SCSI ID): 

These bits contain the SCSI ID that is used when addressing the target. This value may range from 
0 to 31. 

Bit 5 Reserved: 

This bit is reserved and must be set to zero by the host. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the board uses when 
executing the command. When the BUS bit is cleared to 0, the board executes the command over 
the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI bus (Port 1). 

Bit 7 Extended Address Enable: 

Setting this bit enables the extensions to both the LUN’s and the SCSI ID. When this bit is set (1), 
the SCSI device ID shall be extended by two bits into the old LUN field. Bits 0-4 will now be utilized 
for the SCSI device ID. 

Bits 8-13 Extended LUN (EXT LUN): 

The LUN will be taken from the 6 bit field EXT_LUN 

Bits 14-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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ISSUE ABORT MESSAGE ISSUE ABORT MESSAGE 

Command ID: 0x4E Command ID: 0x4E 


Returned Values 

Upon command completion, the following infonnation is provided by the board in the returned lOPB for the 
Issue Abort Message command: 


Return Status (2 Bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an error 
code. Appendix C contains the error codes. 
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Return Status For Abort Message 
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Command Set 


DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


The Download Rrmware command provides a mechanism for firmware to be downloaded to the board. 
The image is then programmed into FLASH EPROM, or the currently executing merrwry image. This allows 
firmware to be upgraded without physically replacing the EPROM. 

To complete the firmware download requires the following steps: 

• initiate the Firmware Download, by issuing the Download Firmware command with the initialize Flash 
bit set in the Command Options. 

• Transfer the new firmware to the board by issuing a series of Download Firmware commands with the 
Download Packet bit set in the Command Optbns. 

• Program the new firmware into either Rash EPROM or Memory, by issuing the Download Rrmware 
command with either the Program Flash or Program memory bit set in the Command Issues. 

This command may only be submitted through the Master Command Entry to Work Queue 0. 
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DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


WORD # 

16 14 13 1 12 

11 10 

B 

B 

1 

0X00 

COMMAND CODE (0x4F) 

0X01 

COMMAND OPTIONS 

0x02 

RETURN STATUS 

0x03 

RESERVED 

0x04 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

0X05 

INTERRUPT LEVEL 

0x06 

RESERVED 

0x07 

RESERVED 

TT 

MT 

ADDRESS MODIFIER 

0x08 

BUFFER ADDRESS (MSW) 

0x09 

OxOA 

TRANSFER LENGTH (MSW) 

OxOB 

OXOC 

CHECK SUM (MSW) 

OXOD 

OxOE 

RESERVED 

OxOF 

SEQUENCE NUMBER 

0X10 

RESERVED 

0X11 

0X12 

0x13 

0x14 

0x15 


NOTES: Reserved fields must be cleared to 0 by the host 


Figure 5-22 Download Firmware lOPB 


Host-Provided lOPB Fields 

The following information must be provided in the lOPB for the Download Firmware command. 

Command Code 

This field must be set to 0x4F to execute the Download Firmware command. 
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Command Set 


DOWNLOAD FIRMWARE 

Command ID: 0x4F 


DOWNLOAD FIRMWARE 

Command ID: 0x4F 


CommoMid Options 


This field contains the options for this command. The bits are defined as follows: 


15 i 14 I 13 i 12 i 11 i 10 i 9 i 8 i 7 i 6 i 5 i 4 I 3 i 2 i 1 i 0 i 

I » I r" I » T 'I -“- i U t-i l - , . J t-i I I , i i„„r ii - « . . .pi i -n-i i 

I I—,—I I I- 1 -1 till '-1-' ^INTERRUPT ENABLE 

I I 1 I I I I I '--RESERVED 

III I III '--INITIALIZE DOWNLOAD 

III i 11 I--TRANSFER PACKET 

III I I I--PROGRAM FLASH 

III I I--PROGRAM MEMORY 

I I I I-:--RESERVED 

I I I--MOTOROLA S-RECORDS 

I I--RESERVED 

I-- DEBUG 


Command Options For Download Firmware Command 


Bit 0 Interrupt Enable: 

Setting this bit enables the board to generate and intermpt to the host upon command completion. 
Clearing this bit disables the Command Complete Interrupt. Setting this bit in conjunction with the 
Program Memory bit has no effect: no interrupt will be generated, and no lOPB returned. 

Bits 1-3 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 4 Initialize Download: 

Setting this bit causes the command to initiate the download process. A command with this option 
bit set will be referred to as an initialize Download sub-command. 

If the firmware to be downloaded is Motorola S-Record (subtype S3), bit 12 should also be set for the 
Initialize Download sub-command. 

Bit 5 Transfer Packet: 

Setting this bit causes this command to download to the board one in a sequence of packets 
containing the new firmware. A command with this option bit set will be referred to as a Transfer 
Packet sub-command. 

Bit 6 Program Flash: 

Setting this bit causes this command to program the Flash EPROM with the newly, downloaded 
firmware. A command with this option bit set will be referred to as a Program Flash sub-command. 
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DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


Bit 7 Program Memory: 

Setting this bit causes this command to replace the currently executing program image with the newly, 
downloaded firmware. A command with this option bit set will be referred to as a Program Memory 
sub-command. 

This sub-command does not return. In all cases, the board will require re-initialization. If the 
command succeeds, the board will first report Controller Not Available through the Master Status 
Register, which will change to Board OK status when the new executing image is fully running. Then, 
the host will need to reinitialize the controller, using the Initialize Controller lOPB, and all of the work 
queues, using the initialize Work Queue iOPB, exactly as was done in system startup. 

if the command fails, the board will remain in the Controller Not Available state, and will require a 
Controller Reset to be issued through the Master Command Register, which will cause the previous 
version of firmware stored in EPROM to be re-loaded, and then the controller and work queues will 
need to be initialized 

Bits 8>11 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 12 Motoroia S-Records: 

Setting this bit causes the board to interpret the downloaded firmware as Motorola S-Records, subtype 
S3, which use 4-byte addresses. This bit must be set on the Initialize Download sub-command. 

Bits 13-14 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 15 Debug: 

Setting this bit causes the board to print debugging messages to the Controller Console during the 
process, which can be quite useful during driver development. Failing to set this bit will turn off debug 
printing, until an subsequent IOPB is received with this bit set. 


Normtil Completion Vector/Birror Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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Command Set 


DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 
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ERROR COMPLETION VECTOR 
NORMAL COMPLETION VECTOR 


Normal/Error Completion For Download Firmware Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes^ 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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I I -►INTERRUPT LEVEL 

I-- RESERVED 


Interrupt Level For Download Firmware Command 


Bits 0-2 interrupt Level (LVL): 

These bits set the interrupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed only when interrupts are 
disabled (Interrupt Enable bit = 0 in the Command Options word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 
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DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


VME Transfer Type (2 Bytes) 

These bytes specify the address modifier, memory type, and transfer type to be used for all VMEbus 
transfers associated with the command. 

NOTE: Some memory systems may not support all of the options discussed for this field. 


II — " r ■ I I ' l l ' II " I I " II I I 
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ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 


VME Transfer Types For Download Firmware Command 
Bits 0-7 Address Modifier: 

This byte specifies the address modifier to be used by the board for all VMEbus data transfers 
associated with this command. 

Bits 8-9 Memory Type: 

This 2-bit field specifies the width of data transfers. Permitted values are as follows: 


BITS 

BITS 

MEMORY TYPE 

0 

0 

RESERVED 

0 

1 

16-BIT TRANSFERS 

1 

0 

32-BIT TRANSFERS 

1 

1 

RESERVED 


* Valid only for Scatter/Gather operations 


Memory Type For Download Firmware Command 
Bits 10-11 Transfer Type: 

This 2-bjt field specifies the type of data transfer to be performed. Permitted values are as follows; 
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Command Set 


DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL TYPE 

0 

1 

BLOCK MODE 

1 

0 

(RESERVED) 

1 

1 

VME D64 BLOCK 


Transfer Type For Download Firmware Command 


Bits 12-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bt^er Address 

In the Initialize Download sub-command this field must be set to zero. 

In the Transfer Packet sub-command, this field specifies the address in host memory where the 
board will begin the data transfer for the packet. 

In the Program Rash and Program Memory sub-commands this field must be set to zero. 


Transfer Length 

In the Initialize Download sub-command, this field must be set to zero. 

In the Transfer Packet sub-command, this field specifies the total number of bytes to be 
transferred for the packet. 

In the Program Flash sub-command, this field contains the total number of bytes transferred to 
the board. If this value fails to match the actual number of bytes received, an error will be 
returned. 

In the Program Memory sub-command, this field must be set to zero. 
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DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


Check Sum Value 

In the Initialize Download sub-command this field must be set to zero. 

In the Transfer Packet sub-command, this field contains a calculated error checking value for the 
packet. 

In the Program Flash and Program Memory sub-commands this field must be set to zero. 


Sequence Number 

In the Initialize Download sub-command this field must be set to zero. 

In the Transfer Packet sub-command, this field specifies the total number of Transfer Packet sub¬ 
commands. The first Transfer Packet sub-command sets this value to 1, the next to 2, and so 
forth. Packets must be received by the board in order. 

In the Program Rash sub-command this field contains the total number of packets submitted 
using the Transfer Packet sub-command. 

In the Program Rash sub-command this field must be set to zero. 


Return Status Error Codes 

The following error codes may be returned in the Return Status field for each of the following 
commands: 


'i .. II II ' » ' !!■'■' II " I I' " HT » I I ' II I I I I II "H 
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I I 

I-►ERROR CODE 


Return Status For Download Firmware 
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DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


Table 5-11 Download Firmware Error Codes 


HEX 

CODE 

DESCRIPTION 

COMMANDS 

INITIAUZE 

DOWNLOAD 

TRANSFER 

PACKET 

PROGRAM 

FLASH 

0x90 

Incorrect Hardware 

X 



0x9 i 

Invalid Record Format 

X 



0x92 

Illegal lOPB Value 

X 

X 

X 

0x94 

Invalid Download Operation 


X 

X 

0x95 

Bad Sequence Number 


X 


0x96 

BadCRC 


X 


0x97 

Translation Error 


X 

X 

0X99 

Bad Packet Count 



X 

0X9A 

Bad Transfer Count 



X 

0x9B 

Bad EPROM Checksum 



X 

0x9C 

Illegal image 



X 

0x90 

Bad EPROM Image 



X 


All of the error returns except the last (0x9D. Bad EPROM Image) are recoverable: the download 
process is aborted, no change is made to the EPROM. However, after the process of programming 
the EPROM has started, any error will leave the EPROM in a totally useless state, and it will have to 
be physically replaced. 

The only other action that can be taken after the recoverable errors is to restart the process from the 
Initialize Download sub-command. 

After the FLASH has been programmed, all subsequent SCSI Pass-Through lOPB’s will be returned 
to the host with the exception code. 

0x9F In-Core Memory Fails To Match EPROM Image. This will be reported as an Exception, using 
the Normal Completion Vector, but setting the EX bit In the CRSW. 
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DOWNLOAD FIRMWARE DOWNLOAD FIRMWARE 

Command ID: 0x4F Command ID: 0x4F 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB for the 
Download Firmware command. Transfer length reflects the number of bytes transferred. 
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Command Set 


SET SERIAL NUMBER SET SERIAL NUMBER 

Command ID: 0x52 Command ID: 0x52 


The Set Serial Number command provides a mechanism by which the host can install two (2) 6-byte serial 
numbers on the board in non-volatile RAM (NVRAM). One use for this command is to provide host system 
software the opportunity to limit access to boards obtained through a particular distribution channel. 

There are four (4) serial numbers, two (2) user serial numbers and two (2) Factory Serial Numbers set by 
the manufacturer. The serial numbers are reported in Controller Specific Space immediately following the 
Configuration Status Block. The Primary User Serial Number is at offset 0x7E8, the Secondary at offset 
0x7EE. The Primary Factory Serial Nurnber is at offset 0x7F4, the Secondary at offset 0x7FA. 

Note; The Factory Serial Numbers are in the format of an Ethernet MAC node address, and cannot be 
altered by the host. 


This command must be issued through the Master Command Entry to work queue 0. The format of the 
lOPB is as follows: 



Figure 5-23 Set Serial Number Command 
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SET SERIAL NUMBER SET SERIAL NUMBER 

Command ID: 0x52 Command ID: 0x52 


ComnuMJid Code 

This field must be set to 0x52 to install the Host Serial Number. 

Command Options 

This field contains the options for this lOPB. The bits are defined as follows: 


I 15 i 14 i 13 i| 12 H 11 i 10 
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.INTERRUPT ENABLE 
.RESERVED 


Command Options For Set Serial Number Command 


Bit 0 Interrupt Enable 

Setting this bit enables the Cougar to generate an interrupt to the host upon command completion. 

Bit 1 Secondary Number 

Setting this bit causes the specified Host Serial Number to be installed in the secondary, rather than 
the primary, location. 

Normal Completion Vectar/Error Completion Vector (2 Bytes) 

These two bytes specify the VMEbus interrupt vectors that the board will use to report normal 
command completion and command completion with error. 
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1 i _►ERROR COMPLETION VECTOR 

1_►NORMAL COMPLETION VECTOR 


Normal/Error Completion Vector For Set Serial Number Command 


Bits 0-7 Error Completion Vector: 

This value specifies the Interrupt vector used when notifying the host of command completion with 
error. 


5-130 




Command. Set 


SET SERIAL NUMBER SET SERIAL NUMBER 

Command ID: 0x52 Command ID: 0x52 


Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command completion 
(normal or with error). 
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-INTERRUPT LEVEL 
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Interrupt Level For Set Serial Number Command 


Bits 0-2 Interrupt Level: 

These bits set the intenupt level used by the board to assert a Command Complete interrupt on the 
VMEbus. Values of 0 through 7 are allowed with a level of 0 allowed only when interrupts are 
disabled by clearing the interrupt enable bit in the Command Options word. 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

SeriiMl Number 

These six bytes contain the Host Serial Number to be installed in NVRAM, and displayed in CSS. 
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SET SERIAL NUMBER 

Command ID: 0x52 


SET SERIAL NUMBER 

Command ID: 0x52 


Return Status (2 Bytes) 

This field provides the return status for the command. 
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ERROR CODE 
PASS-BACK STATUS 


Return Status For Set Serial Number Command 


Bits 0-7 Error Code: 

The Error Code byte describes the status of the controller at the end of the command response. Any 
non-zero value is an error code. Appendix C contains the error codes. 

Bits 8-15 Pass-Back Status: 

This value is the SCSI status byte returned by the target device. It is not changed by the board. A 
value of 0x0 indicates Good Status. A non-zero value indicates that a SCSI device error has 
occurred. 


NOTE: The board can be configured to respond to a non-zero pass-back status by: 

• Freezing the queue, 

• Aborting all commands in or destined for the queue, or 

• Initiating autosense error recovery 

The work queue options are set via the Initialize Work Queue command, and are mutually 
exclusive. (See Work Queue Options, page 5-52 and Error Recovery Tools in Chapter 6 for 
details). 

Serial Numbers Reported in CSS. 
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Command Set 


SET SERIAL NUMBER 

Command ID; 0x52 


SET SERIAL NUMBER 

Command ID: 0x52 


WORD# 15 14 13 12 11 10 9 8 


6 5 







OEM INSTALLED SERIAL NUMBER (BYTES 1.2) 
(PRIMARY) 


(BYTES 3,4) 


(BYTES 5.6) 


OEM INSTALLED SERIAL NUMBER (BYTES 1.2) 
(SECONDARY) 


(BYTES 3.4) 


(BYTES 5.6) 


MFR INSTALLED SERIAL NUMBER (BYTES 1.2) 
(PRIMARY) 


(BYTES 3.4) 


(BYTES 5.6) 


MFR INSTALLED SERIAL NUMBER (BYTES 1.2) 
(SECONDARY) 


(BYTES 3.4) 


(BYTES 5.6) 



Figure 5-24 Controller Serial Number 
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BUFFER FIFO 

Command ID: 0x53 


BUFFER FIFO 

Command ID: 0x53 


The Buffer FIFO command provides backward compatibility for drivers and diagnostic routines that 
previously used the 4210 Jaguar Buffer FIFO command. This command may be used for testing various 
transfer options and boundary conditions, as well as fault isolation. 

This command turns onboard data buffer memory into a large FIFO (First-ln-First-Out) buffer that the host 
can read and write. Since no constraints are imposed on teh structure of the data requests, transfer counts 
may be even or odd and starting buffer addresses in host memory may be aligned or unaligned. 

The structure of the read and write commands used are independent. For example, the host may write 
128K of data with a single command, then read it with 64 2K commands. A scatter/gather operation may 
be used to write, and a non-scatter/gather operation to read. 

This command must be issued through the Master Command Entry to work queue 0. The format of the 
lOPB is as follows: 


WORD # 

15 1 14 13 I 12 11 1 10 9 8 

BBHIIBBBD 

0x00 

COMMAND CODE 

0x01 

COMMAND OPTIONS 

0x02 

RETURN STATUS 

0x03 

RESERVED 

0x04 

NORMAL COMPLETION VECTOR 

ERROR COMPLETION VECTOR 

0x05 

INTERRUPT LEVEL 

0x06 

RESERVED 

0x07 

DMA TRANSFER CONTROL WORD 

0x08 

BUFFER ADDRESS (MSW) 

0x09 

(OR SCATTER/GATHER LIST ADDRESS) (LSW) 

OxOA 

MAX TRANSFER LENGTH (MSW) 

OxOB 

(OR SCATTER/GATHER ELEMENT COUNT) (LSW) 

OxOC 

RESERVED (MSW) 

OxOD 

(OR SCATTER/GATHER TRANSFER COUNT) (LSW) 

OxOE 

To 

0x15 

RESERVED 
(16 BYTES) 


Figure 5-25 Buffer FIFO Command 
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BUFFER FIFO 

Command ID: 0x53 


BUFFER FIFO 

Command ID: 0x53 


The remainder of this section describes the function of each field in the Buffer FIFO lOPB. 


Host Provided lOPB Fields 

The following information must be provided in the lOPB for the Buffer FIFO command: 


Command Code 

This field must contain the value 0x53 to execute the Buffer FIFO command. 

Command Options 

This field defines options for this command. The following sub-fields are defined: 


II II "■ 

II 15 B u 

Uii .. Jl III II 


13 i 12 i 11 i 10 i 9 i 8 i 716 i 5 i 4 i 3 j 3 i 2 i 1 i o" i 

" " " » " I " " " " " “ ■' " I " —■' 

I I i-►INTERRUPT ENABLE 

I I-►SCATTER/GATHER ENABLE 

I-►DIRECTION BIT 


Bit 0 Interrupt Enable: 

Setting this bit causes the controller to generate an Interrupt to the host upon command completion. 
Bit 1 Scatter/Gather Enable: 

Bit 8 Direction Bit: 

Setting this bit allows the host to write data to the controller. Clearing this bit allows the host to read 
data from the controller. 

Nmmal Completion Vecttfr/Error Completion Vector (2 Bytes) 

These two fields specify the VMEbus interrupt vectors that the controller will use to report normal or 
error command completion status back to the host. 

i 15 ii 14 i 13 i 12 i 11 i 10 ii 9 fl 8 i 7 i 6 il 5 ii 4 i! 3 i 2 i 1 ij o j 

I - " " " ■' » I “ , " *' -1-" 

t-^-1 I-1 

I '-. ERROR COMPLETION VECTOR 

I-►NORMAL COMPLETION VECTOR 

Normal/Error Completion Vector For Buffer FIFO Command 
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BUFFER FIFO 

Command ID: 0x53 


BUFFER RFO 

Command ID: 0x53 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command completion with 
error. 

Bits 8-15 Normal Completion Vector: 

This value specifies the interrupt vector used when notifying the host that the command completed 
without error. 


Interrupt Level (2 Bytes) 


This field specifies the VMEbus interrupt level used by the controller to notify the host of command 
completion, if the Interrupt Enable bit is set in the Command options field. Legitimate values for this 
field range from 1 to 7. 



I 7 I 6 I 5 I 4 i 3 I 2 B 1 « 0 


INTERRUPT LEVEL 
RESERVED 


Interrupt Level For Buffer FIFO Command 


VBSE Tranter Type (2 Bytesi 

This field defines the parameters for the DMA transfer associated with the command. If scatter/gather 
IS enabled, this applies to the DMA transfer of the scatter/gather list from the host memory. Transfer 
words for the actual data elements are then contained in each scatter/gather list element. If 
scatter/gather is not enabled, this applies to the actual transfer of data associated with this command. 

Bits 0-7 Address Modifier: 

This sub-field specifies the VMEbus address modifier to be used with the transfer. 

Bits 8-9 Memory Type: 

This sub-field specifies the width of the data transfers, as follows: 
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BUFFER RFO 

Command ID: 0x53 


BUFFER FIFO 

Command ID: 0x53 


BIT 9 

BITS 

MEMORY TYPE 

0 

0 

(RESERVED) 

0 

1 

16-bit transfers 

1 

0 

32-bit transfers 

1 

1 

Scatter/gather list resides in short I/O* 


* Valid only for Scatter/Gathar operations 

Bits 10-11 Transfer Type: 

This sub-field defines the type of the data transfer, as follows: 


BIT 11 

BIT 10 

TRANSFER TYPE 

0 

0 

NORMAL TYPE 

0 

1 

BLOCK MODE 

1 

0 

(RESERVED) 

1 

1 

VME D64 BLOCK 


Buffer Address (4 Bytes) 

This field specifies the address at which the controller will begin the data transfer. If the controller is 
addressing system memory, the value in the field is a VMEbus address. If the address is in short I/O, 
the value is an offset from the short I/O base address. If scatter/gather is enabled, this field is the 
address of the scatter/gather list. 



14 

13 

12 

11 



8 

[H 


m 

4 


2 

1 

0 

MSW 

LSW 

BUFFER ADDRESS 
(or Address of Scatter/Gather List) 


Buffer Address For Buffer FIFO Command 
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BUFFER FIFO 

Command ID: 0x53 


BUFFER FIFO 

Command ID: 0x53 


Maximum Tranter Length (4 Bytes) 

This field specifies the maximum number of bytes that may be transferred by the command. If this 
field is zero, and the Command specifies a write, ail accumulated data will be flushed from the 
controller FIFO. 

NOTE: In the returned lOPB of the the command response, this value reflects the actual number 

of bytes transferred. 



Reserved (4 Bytes) 

Unless scatter/gather Is enabled, words OxC and OxD of the SCSI Pass-Through lOPB are reserved 
and must be cleared by the host. For scatter/gather operations, this field specifies the sum of the 
individual element entry counts. See the Scatter/Gather Operations in Chapter 6 for details. 

The Buffer FIFO command can be used to generate certain error conditions, by setting the value of 
the following fields to produce the corresponding errors: 


MAX 

BUFFER 

S/G 

RETURNED 

TRANSFER 

ADDRESS 

COUNT 

EVENT 

0 

0 

0 

NO-OP 

0 

NON-ZERO 

0 

FORCE ERROR 

0 

NON-ZERO 

NON-ZERO 

CONTROLLER PANIC 
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BUFFER RFO 


BUFFER FIFO 


Command ID; 0x53 


Command ID; 0x53 


Returned Values 

Upon command completion, the following information is provided by the board in the returned lOPB of the 
command response for the SCSI Pass-Through command. 

Return Status (2 Bytes) 

This field provides the return status for the command. 


a. ~i i '■ " I I ■■ ni "I I ' ' I ," I I" I I '■ i r " i i i i i i ' r ii ir n ii i i 

11 15 n 14 II 13 II 12 B 11 II 10 H 9 B 8 li 7 i 6 II 5 11 4 B 3 II 3 II 2 II 1 II 0 11 

" , ■' •' " ' •' '' 1 " , ” " •' - ” '' - " " - 


ERROR CODE 
PASS-BACK STATUS 


Return Status For Buffer FIFO Command 


Bits 0-7 Error Code; 

The Error Code byte describes the status of the controller at the end of the command response. Any 
non-zero value is an error code. Appendix C contains the error codes. 
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Application Notes 


This chapter contains application notes on the following: 

• Error Recovery Tools 

• Scatter/Gather Operations 

• Printer Port Operations 

• Offboard lOPBs 

• Considerations For Maximizing SCSI Synchronous Data Transfers 

• Download Rrmware 

• MACSI SCSI Synchronous Options 

• Board identification in MACS! CSS 


Error Recovery Tools 

The board supports a variety of tools for dealing with two basic types of errors that can occur - SCSI device 
errors and controller errors. These error recovery tools are described in the following subsections. They 
are also documented where appropriate in the MACSI and command set sections of the manual. 


SCSI Device Errors 

A SCSI device error is defined to be the completion of a SCSI Pass-Through lOPB with a value 
other than 0x0 (Good Status) in the Pass-Back status byte of the lOPB Return Status word (see 
Chapter 5). The controller supports a variety of tools for dealing with device errors, including: 

— Autosense recovery 

— Freeze/Thaw Work Queue 

— Abort Work Queue on Error 

— Fields in the Configuration Status Block for determining SCSI bus status and the 
last device on the bus 

— Several error recovery commands 

These tools are described in the following subsections. 

Autosense Recovery 

The Autosense Recovery feature can be used to obtain the sense data (if any) reported by a SCSI 
device after executing a SCSI command that returns pass-through error status indicating a SCSI 
check condition. This feature is enabled on a per-work queue basis by setting the Enable 
Autosense Recovery bit in the Work Queue Options field of the Initialize Work Queue command. 
When this feature is enabled, a work queue will NOT freeze and thaw. 
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When the host issues a SCSI Pass-Through command to a work queue with Autosense Recovery 
enabled and a SCSI check condition is returned by the device, the board follows the command with 
an automatic Request Sense to the target device. The target device responds to the Request 
Sense by sending the board its sense data reported in the SCSI command’s returned lOPB, 
starting at the CDB field (i.e. SCSI bytes 0-11). 

Since the sense data may extend past the boundaries of the original lOPB, additional space must 
be allocated to the Command Response Block (CRB) for returned sense data. If the data is being 
reported to an off board CRB, the host must ensure that adequate space exists for this data to be 
written without generating system bus errors. For details on setting the onboard CRB size, refer 
to Chapter 5, Initialize Controller Command. For a discussion of setting up an offboard CRB. 


Freeze/Thcaa Work Queue And Abort Work Queue On Error 

Since a device may have many commands queued for it when an error occurs. SCSI device errors 
require a mechanism which allows the host to alter the order in which commands are executed. 
The Freeze/Thaw Work Queue and Abort Work Queue on Error options are provided for this 
purpose. 

NOTE: The Freeze/Thaw Work Queue and Abort Work Queue on Error options are mutually 
exclusive. That is, a given work queue cannot be both frozen and aborted in the event of an error. 
Autosense recovery and Freeze/Thaw Work Queue are also mutually exclusive. If the Autosense 
Recovery is enabl^ for a work queue, the queue will not freeze. 


Freeze Work Queue on SCSI Bhrror 

The Freeze Work Queue option provides a mechanism for freezing the state of a work 
queue when an error occurs. Error handling can be accomplished by passing one or more 
corrective commands to the device (such as Request Sense or a diagnostic command). 
Such commands must be issued to the device through the Master Command Entry via 
Work Queue 0. After the error handling has been completed, the work queue can be 
unfrozen. 

The Freeze Work Queue option is enabled on a per-queue basis when the queues are 
initialized. To enable the Freeze option for a given queue, set Bit 2 (FZE) in the Work 
Queue Options field of the Initialize Work Queue lOPB (see Chapter 5, Initialize Work 
Queue Command). 
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ABORT ENABLE 
RESERVED 

FREEZE WORK QUEUE 
RESERVED 

INITIALIZE WORK QUEUE 


(Word OxF In The Initialize Work Queue lOPB) 

Figure 6-1. Freeze Work Queue Option 


If a work queue is dedicated to a specific SCSI device, enabling the Freeze bit halts all 
further commands to that device (and no other) in the event of a SCSI device error. As 
noted previously, a device error occurs when the host issues a SCSI Pass-Through lOPB 
that completes with any value other than 0x00 (Good Status) in the Pass-Back Status byte 
of the lOPB Return Status word. 

In addition, a bit will be set in the Frozen Work Queues Register of the Configuration 
Status Block (see discussion below). 

Commands sent to a “frozen" work queue will not be executed until the work queue is 
"thawed", as discussed below. 

NOTE: Since the Freeze Work Queue option is intended to support error handling as a 
part of normal SCSI operations, queues are not frozen for controller errors. 

The Freeze Work Queue or Freeze Reset Work Queue operation may also be enabled 
using the Initialize Controller command to freeze a work queue that has an active 
command upon receiving a SCSI reset. The host will "know" a Work Queue is frozen if 
it receives a command returned from the queue with a SCSI bus reset error status. It is 
recommended that you enable this option when initializing the board. The default 
setting (i.e. do not freeze queue if command is returned with SCSI bus reset status) is 
provided for backward compatibility. 

NOTE: The Freeze Work Queue on Error bit is not enabled for Work Queue 0. This is 
because it is defined to have a length of 1. This is done to ensure that only one error 
recovery process occurs at a time. However, It is possible that a command from Work 
Queue 0 may require error recovery itself. To allow this to take place, the SCSI Bus Reset 
and Rush Work Queue commands may always be issued through the Master Command 
Entry to Work Queue 0. For all other commands Work Queue 0 has a length of one. 

Frozen Work Queues Register. Located in the Configuration Status Block, this register 
identifies which work queues are frozen (if any). For Work Queues 1 to 14, if a given 
queue is frozen, then the corresponding bit position is set in the register. As noted before. 
Work Queue 0 cannot be frozen. The format of the register is repeated below for your 
reference: 
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B 15 II 14 II 13 II 12 N 11 II 10 II 9 II 8 li 7 II 6 i 5 B 4 H 3 li 2 II 1 II 0 II 


I I I 
1 I ^ 


► WORK QUEUE© 
►WORK QUEUE 1 
►WORK QUEUE 2 
►WORK QUEUE 3 
►WORK QUEUE 4 
►WORK QUEUE 5 
►WORK QUEUE 6 
►WORK QUEUE 7 
►WORK QUEUE 8 
►WORK QUEUE 9 
►WORK QUEUE 10 
►WORK QUEUE 11 
►WORK QUEUE 12 
►WORK QUEUE 13 
►WORK QUEUE 14 
►RESERVED 


NOTE: Work Queue 0 cannot be frozen. Therefore. Bit 0 in the Frozen Work Queues Register is 
always cleared. 

Figure 6-2. Frozen Work Queues Register 


Thaw Work Queue. After the SCSI error condition has been cleared, the queue can be 
unfrozen by use of the Thaw Work Queue bit in the Master Control/Status Block (MCSB). 
Execution of commands in the frozen queue is restarted by setting the least significant bit 
of the Thaw Work Queue Register Word 0x4 (see Chapter 3, System Interface, for further 
details). 

The frozen work queue is unfrozen by writing the appropriate work queue number into the 
upper byte of the Thaw Work Queue Register and then setting the Thaw Work Queue Bit 0 
(THW) of that register. The board will clear Bit 0 of the register to acknowledge the 
thawing of the work queue. The Thaw Work Queue Register is defined as follows: 


B 15 I 14 ii 13 B 12 

II I.,., ii II 

I_ 




11 B 10 jj 9 jj 8 j| 7 B 6 B 5 a 4 I 3 B 2 



T 

L 


1 ii 0 i 

I ii I ■ 11 

J I—thaw work QUEUE 

-►RESERVED 

-►WORK QUEUE NUMBER 


(Word 0x4 In the Master Control/Status Block) 


Figure 6-3. Thaw Work Queue Register 


Abort Work Queue On E^rror 

The Abort Work Queue on Error option causes the board to abort all commands for that 
work queue until a command is issued with the Abort Acknowledge bit set to 1 in the 
command’s Queue Entry Control Register. This option is mutually exclusive with the 
freeze/thaw work queue feature described in the preceding subsections. A given work 
queue cannot be both frozen and aborted in the event of an error. 
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15 ii 14 il 13 i 12 ii 11 ii 10 ii 9 ii 8 i 7 ii 6 i 5 li 4 ii 3 i 2 


1 I 


I I-►ABORT ENABLE 

I-►RESERVED 

-►FREEZE WORK QUEUE 

ON ERROR 
-►RESERVED 

-►ENABLE AUTOSENSE RECOVERY 

-►REPORT FROZEN WORK QUEUE 

(WIDE FEATURE) 

-►RESERVED 

-►INITIALIZE WORK QUEUE 


(Word OxF in the Initialize Work Queue lOPB) 


Figure 6-4. Abort Work Queue On Error Option 


To enable Abort Work Queue on Error for a given work queue, set Bit 0 of the Work 
Queue Options field when you initialize the work queue. 

When a SCSI Device error occurs, the failing lOPB will be returned with the bad (non-zero) 
pass-back status. All other commands for that work queue will be returned with a 
Command Complete and Abort Queue set to 1 in the Command Response Status Word. 
This will continue until a command is submitted with the Abort Acknowledge bit in the 
command’s Queue Entry Control Register set to 1. This applies not only to the commands 
in the queue when the abort was activated, but to all commands issued to that queue until 
the abort is acknowledged. 


Registers For Determining SCSI Bus Status And Lost Device On Bus 

The Configuration Status Block contains two registers that provide the current SCSI bus status. 
Information in these registers can be used in conjunction with the Command Status Inquiry and Bus 
Status Inquiry commands to determine the type of error that has occurred. 

ID Of Last Device Connected To SCSI Bus. The Last Device ID bytes contain the SCSI 
Bus Ids of the last devices connected to Port 0 and Port 1. Bits 8-15 contain the Primary 
SCSI Bus ID last connected, and Bits 0-7 contain the Secondary Bus ID last connected, 

SCSI Bus Status. The SCSI Bus Status field describes the status of the primary and 
secondary SCSI buses. Bits 8-15 contain the primary bus status. Bits 0-7 contain the 
status of the secondary bus (if used). Both bytes are images of the SCSI processor phase 
sense register. 


Fii Ok Recovery Commands 

Normal SCSI check condition errors are handled very simply via SCSI protocol. However, there 
are other types of errors from which it can be difficult to recover, such as errors due to a bad 
device or bug in the device driver program. 
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The board provides three commands that can be used to determine what type of error has 

occurred without having to reset the board. They are: 

• The Command Status Inquiry command reports the status of a command, identified by 
its command tag. 

• The Bus Status inquiry command reports the state of all lOPBs requesting the SCSI Bus. 
It is used to find the command that is active on the bus at the time an lOPB timeout 
(discussed below) occurred. This is important because a command may cause another 
command to time out by blocking use of the SCSI bus by other devices. 

• Cancel Command Tag removes a (x>mmand from the board. This command is provided 
for systems that can reset devices in error without resetting the SCSI bus. 

The above comn^nds must be issued through the Master Command Entry to Work Queue 0. 

They may be issued at any time. 

For additional Information on commands, refer to the descriptions of the individual commands in 

Chapter 5. 


Selection Aitd Command Timeouts 

The board provides two (2) features to signal unusual errors: 

• Selection timeout 

• Command timeout 

Selection timeouts prevent the board from becoming locked up while trying to select a device that 
does not respond to SCSI selection. Command timeouts let the board notify the host that a user- 
programmed period of time has expired since a device was successfully selected. 


Selectian Timeout 

The selection timeout causes an lOPB to be terminated with an error status if a device 
does not respond to selection within a set period of time (250 milliseconds). 


Cammtxnd Timeout 

The command timeout Is specified in the Initialize Controller command for Work Queue 0, 
and In the Initialize Work Queue command for all other queues. All lOPBs Issued through 
a work queue will use the timeout value specified for that work queue. 
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• For Work Queue 0. words 0x9 of the Controller Initialization Block are used for the 
Work Queue 0 command timeout. This field (word 9) is specified in increments 
of 256 msec. A value of 0 specifies no timeout. 

• The timeout values used for commands Issued through Work Queues 1-14 are 
set when the queues are initialized. The words 0x12-0x13 of the Initialize Work 
Queue command contains the timeout value, which Is specified in increments of 
approximately 256 milliseconds. Thus, each work queue (device) is able to run 
a unique timeout value. A value of 0 specifies no timeout. 

To determine whether or not a command has timed out, the board measures how much 
time has elapsed between the successful completion of the selection phase to the 
completion of the command on the SCSI bus (including all disconnect periods). 

When a command timeout occurs, the board uses the Controller Error Interrupt and Vector 
to inform the host of the condition (see discussion In next subsection). This mechanism 
returns an error status without returning the lOPB that caused the error. Command 
timeouts Invoke a Controller Error Vector Status Block with Error Code OxCI (lOPB 
Timeout) In the Error Code byte of the lOPB Return Status field. If the command 
subsequently completes correctly, the original lOPB will complete properly. The host may 
attempt to cancel the lOPB with the Cancel Command Tag lOPB. This will cause the 
board to terminate any further execution. The canceled lOPB will not be posted back to 
the host. If the lOPB is active on the SCSI bus, the command cannot be canceled and the 
host must either reset the SCSI bus or remove the device from the bus in some external 
manner. The command will then be posted with a Canceled Due to Bus Reset Status or 
Invalid Sequence error if it abruptly disconnects from the bus. 

The board must retain the lOPB which caused the timeout until the error condition has 
been cleared. This is necessary for two reasons. Rrst, it allows the command to be 
completed if the device responds before error recovery can take place. Second, it 
prevents new commands from being issued from the queue until the host can handle the 
error condition. 

The usual technique for clearing errors is to issue a Reset SCSI Bus lOPB. This causes 
all of the commands currently active on that bus to be returned with a bus reset status. 
However, if your system is capable of removing individual devices from the bus, you have 
an alternative to resetting the entire bus. The alternative is to remove the device in error 
and then issue a Cancel Command Tag lOPB to clear the lOPB which is waiting for a 
response from the removed device. 

If a command other than the command that timed out is active on the bus, it will be 
necessary to determine which command actually caused the error. There are a number 
of methods for determining the device in error. One technique is to have the host wait an 
additional period of time and check the board again to see that the state is the same as 
the previous check. This type of error is due either to incorrect programming or to a failed 
device and should be a rare occurrence. 
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Controller Eirror Interrupt And Vector 

Controller errors are generated when an error occurs on the board that is not related to a specific 
lOPB- This can be due to a variety of unusual board-related conditions. They may also be 
generated if the host issues an lOPB that lacks the proper information needed for the command 
to be processed normally. 

The interrupt level and vector used to signal such errors are set in the Controller Error Completion 
Level/Vector field of the Controller Initialization Block. 

Controller errors will not generate an interrupt if the controller error interrupt level is cleared 
to 0 in the Initialize Controller lOPB. However, the board will report controller errors to the 
Command Response Block even if interrupts are not enabled. Controller errors will not 
cause work queues to freeze or abort commands. 

The board flags a controller error by setting the foibwing bits in the Command Response Status 
Word: bit 7 (Status Change), bit 2 (Error), and bit 0 (Command Response Block Valid). Thus, the 
Command Response Status Word will read 0x0085 to signal the error. 

The Controller Error Vector enables the host to determine the source of a variety of errors. These 
include: 


• lOPB type error 

• lOPB timeout 

• A devbe has connected for which no lOPB exists 

• A device is requesting a data transfer of the opposite direction specified by the direction 
bit of the lOPB 

The above-listed error conditions cause the board to return a Controller Error Vector Status Block 
to the Command Response Block. This returned structure does not contain an lOPB. Instead, it 
contains an error code indicating what has happened, along with information from the Command 
Queue Entry that was being executed when the error occurred (command tag, lOPB length, and 
work queue number). 
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Table 6-1. Controller Error Vector Status Block 



Controller Eirror Codes 

The valid error codes which may be returned in word 0x6 of the above block are as 
follows: 

Table 6-2. Returned Error Codes For Controller Error Vector 


CODE 

DEFINITION 

OxCO 

lOPB Type Error. 

OxCI 

lOPB Timeout 

0x82 

A target has reconnected for which no lOPB exists. 

0X83 

A target is requesting more data to be transferred than the IOP6 transfer 
count allows. 

0x84 

A target is requesting a data transfer of bie opposite direction specified in 
the direction bit of the lOPB. 

0x86 

Non-Recoverable SCSI Error. 

OxFF 

A controller error which indicates that a panic has occurred on the board. 
Immediately following the error code in short I/O. an ASCII string will 
indicate the file, line number, and a brief description of the panic. This 
information will only be posted in short I/O. if offboard CRBs are being 
used, the information in the offboard memory will not be updated. 


NOTE: These Error Codes will not freeze the work queue. 


lOPB Type Error (OxCO). The board only supports type zero lOPBs. If the lOPB type 
field (bits 8-11 in word 0 of the Command Queue entry) contains any value other than 
0, the board will not "know" the overall structure of the lOPB and will therefore be unable 
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to process it. This error code indicates that the Command Queue entry contains invalid 
information. 

lOPB Timeout Error (OxCI). An lOPB has timed out. The lOPB will remain active until 
it completes properly or is canceled explicitly. The status of the iOPB may be determined 
with the Command Status Inquiry IOPB. With this error code, the Controller Error Vector 
Status Block information is valid. 

Unknown Device Reconnection (0x82). A SCSI device for which no current IOPB exists 
has re-selected the board. This code indicates that the Controller Error Vector Status 
Block contains invalid information. 

Data Transfer Count Mismatch (0x83). Data counters have been exhausted, but the 
device is requesting more data than the current IOPB can transfer. With this error code, 
the Controller Error Vector Status Block information is valid. The suggested recovery for 
this error is to reset the SCSI code. 

Data Direction Errors (0x84). The direction bit in the IOPB does not match the data 
transfer direction requested on the SCSI bus. This error code indicates that the Controller 
Error Vector Status Block information is valid. 

Non-Recoverable SCSI Error (0x86) An error has occurred which has left the SCSI 
hardware in an unknown state. With this error, the information in the Controller Response 
Block (particularly the Command Tag field) is valid if not zero’s. Refer to the following 
section on reporting Non-recoverable SCSI Errors for details on additional diagnostic 
information returned. 


Reporting Non-RecavercMe SCSI Errors 

A number of environmental causes can force the board's SCSI subsystem Into a non- 
recoverable state. Typically, these causes are related to the electrical characteristics or 
behaviors associated with devices attached to the SCSI bus. Normally, these errors are 
detected and corrected during systems Integration and qualification. 

The occurrence of these errors under normal operating conditions indicates a serious 
malfunction. 

If enabled at initiation, the Non-Recoverable SCSI error will be reported as a controller 
error, using the Controller Error Interrupt Level and Vector. The following bits will be set 
in the Command Response Status Word (CRSW). 

• CRBV (Command Response Block Valid), bit 0 

• RE (Error), bit 2 

• SC (Status Change), bit 7 

• SE (SCSI Error), bit 11 
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Thus, the value of the CRSW for this error will be 0x0885. To enable this error recovery 
feature, set bit 2 of the Error Recovery Options word in the Controller Initialization Block 
at Controller Initialization. 

The controller error returned will be error code 0x86 and the 16-bit word following this error 
code will contain the following information: 



M 7 B 6 B 5 I 4 I 3 II 2 II 1 II 

■—-11 II II III -JL 


0 II 


SCSI Error Code 
Bus 0 
Bus 1 
Reserved 


Figure 6-5. SCSI Error Code 16 Bit Word 


Bits 0-11 SCSI Error: 

This field contains the actual SCSI error code. 

Bit 12 Bus 0: 

This bit will be set when the error occurred on the primary SCSI channel. 

Bit 13 Busi: 

This bit will be set when the error occurred on the secondary SCSI channel. 

Bits 14-15 Reserved: 

These bits are reserved and must be set to zero. 

Once in this condition, the SCSI bus must be reset in order to return the SCSI subsystem 
to functional status. 

If this option is not envied, non-recoverable SCSI errors will produce a controller panic, 
requiring reinitialization of the controller. 


Suggested Error Recovery Sequence 

The following is a suggested series of steps which may be taken by the host to recover from an 
error: 


The host issues a Bus Status Inquiry to examine the status of commands 
executing on the bus. This enables the host to determine which command caused 
the error. Note that the command which timed out may not be one that is actually 
blocking the SCSI bus. The command that is most likely in error will be the one 
active on the bus when the Bus Status Inquiry is executed. 
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• If a device is found to be connected on the SCSI bus indefinitely, there is no way 
to clear the error without resetting the bus. When this is the case, the host should 
issue the Reset SCSI Bus lOPB through the Master Command Entry. All work 
queues with commands active on the bus will have those commands returned with 
a SCSI Reset Error status, and the work queue will be frozen (if the Freeze Work 
Queue on Reset option was selected in the initialize Controller Command). 

• The device which caused the error should either be removed or tested before 
restarting normal operation. The host can then reissue the commands and thaw 
the work queues. 

• For systems that have the ability to power down individual devices, the Flush Work 
Queue command can be used to prevent new commands from being issued to the 
device after the error has been cleared, it is not mandatory to flush the work 
queue before restoring the device, but be aware that the board will begin 
processing the commands from the queue as soon as; 1) the bus becomes 
available, and 2) the command that was being executed is cleared. 

After powering down the device, the host should issue a Cancel Command Tag 
lOPB to clear the command which caused the error (i.e. the lOPB that was not 
completed by either a normal SCSI completion or by a SCSI reset). 

NOTE: The Flush Work Queue Command does not flush commands that are 
presently active on the bus. These may only be canceled by: 1) a normal 
command completion, 2) a SCSI reset, or 3) a Cancel Command Tag lOPB. 


Scatter/Gather Operatums 

The scatter/gather option allows contiguous peripheral data to be written to non-contiguous areas in system 
memory ("scatter"), or moved from non>contiguous blocks of system memory into contiguous ones 
("gather"). Scatter/gather operations can only be performed with SCSI peripheral data. They cannot be 
used in conjunction with the printer port. 

By allowing multiple blocks of data to be transferred using only one command, scatter/gather frees the host 
from having to process multiple transactions when transferring non-contiguous blocks. This improves 
system performance by minimizing both the number of VMEbus intenupts and the number of bus 
transactions associated with common peripheral activity. 

To enable scatter/gather, set bit 1 of the Command Options word in the SCSI Pass-Through lOPB. 
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(Word 0x1 In The SCSI Pass-Through lOPB) 


Figure 6-6. Command Options Word In The SCSI Pass-Through lOPB 


With scatter/gather enabled, the following three lOPB fields reference the Scatter/Gather Element List: 1) 
Memory Type/Transfer Type/Address Modifier. 2) Buffer Address, and 3) Transfer Length. The Memory 
Type/Transfer Type/Address Modifier field has the same definition as it does for lOPBs which do not 
perform scatter/gather operations, except for the Link bit (Bit 15). For an explanation of this bit, see 
"Scatter/Gather List Linking" below. 
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ADDRESS MODIFIER 
MEMORY TYPE 
TRANSFER TYPE 
RESERVED 
LINK 


(Word 0x7 In The SCSI Pass-Through lOPB) 

Figure 6-7, Memory/Transfer Type/Address Modifier For Scatter/Gather Operations 


When scatter/gather Is used, words 0x8 - 0x9 of the lOPB contain the address of the scatter/gather list. 
If the Memory Type is 0x1 or 0x2, the value is interpreted as an address in system memory. 



Figure 6-8. Scatter/Gather List Address 


Words OxA - OxB contain the number of elements in the scatter/gather list. Valid entries in this field are 
1 to 256 (decimal). 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


RESERVED 


RESERVED 


S/G ELEMENT COUNT 


(Words 0xA*0x6 In The SCSI Pass-Through lOPB) 

Figure 6-9. Scatter/Gather Element Count 


Words OxC - OxD of the lOPB specify the sum of the individual element entry counts. 
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TOTAL TRANSFER LENGTH (4 BYTES) 





(Words OxC-OxD In The SCSI Pass-Through lOPB) 

Figure 6-10. Total Transfer Length For Scatter/Gather Operations 


Scatter/Gather List 

The scatter/gather option uses a list of elements to control the scatter/gather operation. Each 
element in the list specifies the byte count, address, memory type, and address modifier for each 
block of data in system memory that is to be transferred by one SCSI Pass-Through command. 
Each element in the list is an 8-byte entry. The format is as follows: 
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WORD # 

15 

14 13 12 

11 1 10 

9 8 

B 

1 

1 

H 

0 

ELEMENT 1 BYTE COUNT (2 BYTES) 

1 

2 

ELEMENT 1 BUFFER ADDRESS (4 BYTES) 

3 

LNK 

RESERVED 

TT 

MT 

ADDRESS MODIFIER 


WORD # 

rri 

CM 

11 10 

9 8 

B 

I 

HH 

B 

n*4 

ELEMENT N BYTE COUNT (2 BYTES) 

{n*4) 

+1 

(n*4) 

+2 

ELEMENT N BUFFER ADDRESS (4 BYTES) 

+3 

LNK 

RESERVED 

TT 

MT 

ADDRESS MODIFIER 


Figure 6-11. Scatter/Gather Element List Format 


This scatter/gather list can have from 1 to 255 elements. Using scatter/gather for lists with just one 
element, however, would be inefficient. 


Scatter/Gather List lAiUcing 

To facilitate larger scatter/gather lists, any element in the scatter/gather list may contain 
a LINK bit. When LINK (bit 15) is set, the element structure will contain information that 
points to the next group of scatter/gather elements. An element that forms a link should 
have the following structure: 
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LNK— 1 

Figure 6-12. Link Element Structure 


The scatter/gather count field contains the number of elements in the next link to be 
gathered by the board. Valid Counts are 1 to 256. 

if scatter/gather list linking is used, all lists must be built at the time the lOPB is issued, in 
addition, the Total Transfer Count field in the lOPB must be contain the sum of all 
individual data element counts (it should not contain the link element counts). 


Printer Port Operation 

The board’s printer port allows the host to transfer data to either a Centronics or Dataproducts short line 
interface printer. A version is also available for use vrith a Dataproducts Long Line interface. 

The printer port is a daughter card that attaches to the board. To execute a print command, the host 
issues an lOPB to Port 1 in much the same fashion as it would to a SCSI device. With the printer port 
installed, Port 1 is dedicated to the printer and cannot be used for SCSI transactions. 

When sending data to the printer, the board DMAs the printer data from host memory, transfers it to the 
printer via Port 1, arxl then returns a completion status. Printer status may be monitored a synchronously 
at any time by the host. The host may also request that the board interrupt the host when a status change 
occurs. The printer port does not affect the normal operation of the primary SCSI port (Port 0). 


Verifying Printer Port Installation 

Once the host has initialized the board, it can verify that the printer port is installed by checking 
the Daughter Card ID field in Configuration Status Block. The printer port identification code (0x04) 
should be stored In this field. For information on setting the port’s jumpers and termination, refer 
to the installation chapter. 


6-16 






































Application Notes 


Initicdizing The Port 

The printer port requires a separate work queue. It will therefore be necessary to create a work 
queue for it using the Initialize Work Queue command, just as you would for a SCSI device. This 
work queue must be exclusively used for the printer port. The first command to the printer work 
queue should be the Initialize Printer Port command. This command sets a variety of parameters. 
Including: 1) the polarity of parity for Dataproducts printers, and 2) which printer status lines may 
generate a status change interrupt. 

The Initialize Printer Port command can be issued at any time to reset the printer port. The 
command is issued with the reset bit set to clear the printer port hardware, it should never be 
necessary to reset the hardware. The command may also be issued at any time to assert a buffer 
clear to the printer. Since the time required for holding this signal varies from printer to printer, the 
board will leave the line set until the host issues another Initialize Printer Port command with the 
bit cleared. 


Issuing Printer Conunands 

The board will queue printer commands (see Printer Port lOPB) as received and work on each 
command In a FIFO manner as the previous command completes. When the Go/Busy bit for a 
printer command is set, the command will be copied from short I/O space into the internal printer 
port work queue. After the lOPB has been parsed for correctness, the data will be simultaneously 
DMA'd from system memory. When all the data has been transferred to the printer, a copy of the 
lOPB modified with the current printer status and return code will be placed in the Command 
Response Block. 

BOARD 


-- Command Complete 

* - Command<s) Complete 

-- Command Complete 

-- Command(s) Complete 


HOST 

Initialze Controller lOPB 
Initialize Work Queue lOPB(s) 
Initialize Work Queue iOPB(s) 
Printer Port lOPB(s) 


Figure 6-13. Example Of Printer Port Operation 


If the printer port Is configured for the Dataproducts interface, the host may want to send special 
font or control characters to the printer using the Paper Instruction control line of the Dataproducts 
interface. The board supports this with the Paper Instruction option in the lOPB. When the Paper 
Instruction option is set to 1, the board will transfer ail of the data specified in this lOPB to the 
printer with the Paper Instruction interface signal active. Paper Instruction is only supported by 
Dataproducts printers. 


6-17 






Chapter 


6 


Status Reptnting 

The printer status may be accessed in three ways from the board: 

• The state of the status lines is updated periodically in Configuration Status Block for 
asynchronous monitoring by the host. This status is stored in the Secondary Phase 
Sense/Printer Status field of the Configuration Status Block. For a Dataproducts interface, 
this byte is updated whenever Online. Ready, Parity Error, or Cable On changes state. For 
a Centronics interface, it is updated anytime Select, Fault, or Paper Empty changes state. 
For ail interfaces, it is also updated approximately every 30 msec, as well as at the 
completion of a print command. 

• The second method is for the board to use the Controller Normal Interrupt Vector specified 
in word 0x2 of the Controller Initialization Block. The host may select which status lines 
can generate an interrupt in the Initialize Printer Port lOPB. An Interrupt is generated 
when an enabled status line (except parity) toggles either active or inactive. Parity error 
is only reported when it becomes active. The complete status word will be updated in 
Configuration Status Block, and a Command Response Block will be posted. This returned 
structure is shown in Chapter 3. 

• The third method for accessing printer information is to issue a Printer Port lOPB with both 
the Maximum Transfer Length and the Printer Transfer Length fields set to zero. This 
causes the printer port to update the Printer Status field of the lOPB and immediately 
return it as command completed. 


OffboardlOPBs 

The board’s MACSI interface is optimum for systems that have quick host access to the VME Short I/O 
space. In some systems, however, reading and writing data to/from this space can be quite time 
consuming. To speed up I/O in such systems, the board supports a technique that enables the host to 
control the board with just two reads and two writes into the board’s short I/O space for each command. 
This technique involves building Offboard Command Queue entries, lOPBs, and an Offboard Command 
Response Block. 

NOTE: To execute Offboard lOPBs, the board must have access to the host memory using its DMA facility. 

Overview 

In order to implement Offboard lOPBs, you will need to allocate one or more blocks of system 
memory for sole use by these structures. The board’s onboard Command Queue entries can then 
be initialized to point to these fixed areas of memory. The host builds offboard lOPBs and 
Command Queue entries in this space. The only time it accesses the board’s onboard Command 
Queue entry is to set the Go/Busy bit. 

NOTE: These pointers should not be changed once normal board operation has begun. 

The board then DMAs the offboard CQE/IOPB onboard and executes the command. Upon 
completion of this command fetch, the board clears the Go/Busy bit in the onboard Command 
Queue entry. 
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Building Offboard lOFBs 

To build an offtx)ard lOPB, set the Fetch Offboard lOPB bit (bit 4) in the Queue Entry Control 
Register. This is the first word of the onboard Command Queue entry. Setting this bit changes 
the purpose of the fields within the Comrr^nd Queue entry, but it does not change the size of the 
Command Queue entry. 

When bit 4 is set, the board interprets the address in the onboard Command Queue entry as a 
pointer to a block of offboard memory consisting of an external Command Queue and one or more 
Command Queue entries. 

Qffboard Command Queue entries and IQPBs have the same structure as their onboard 
counterparts, except that the IQPB Address field in an offboard Command Queue entry has no 
meaning. 


The format of an offboard Command Queue entry is shown below: 


WORK# 

15 1 14 13 12 

11 10 

9 8 

7 6 1 5 4 3 2 1 0 

0X0 

QUEUE ENTRY CONTROL REGISTER 

0X1 

RESERVED 

TT 

MT 

ADDRESS MODIFIER 

0 x2 

0x3 

HOST MEMORY ADDRESS 

0X4 

lOPB LENGTH 

RESERVED 

0x5 

RESERVED 


Figure 6-14. Format Qf Qffboard Command Queue Entry 


Note the following important restrictions when building offboard Command Queue entries/IQPBs: 

• Each offboard Command Queue entry must be contiguous with its corresponding 
offboard IQPB In system memory (with the Command Queue entry residing In the 
/ower portion of the block of memory). 

• Because a single DMA operation of the board cannot cross nonadjacent page 
boundaries, an offboard Command Queue entry and its corresponding IQPB 
cannot be spread across two nonadjacent pages in physical memory. 

The host may mix onboard and offboard commands by setting (or clearing) the FQB Bit in the 
Queue Entry Control Register of individual commands. However, this is not recommended for 
normal operation. It may be useful for handling errors or when operating the board in a stand 
alone fashion. 
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Initializing cyffboard Ctmunands 

To initiate a command, the host: 1) reads the Go/Busy bit of the next Command Queue entry to 
ensure that the entry is available, and 2) sets that same Go/Busy bit after it has assembled the 
offboard Command Queue entry and lOPB. 

If there is no external memory at the tocation specified in the Command Queue entry, the board 
will get a VME bus error (BERR*) when it tries to read the offboard Command Queue entry/IOPB. 
in this event, the board uses the default Error LevelA^ector in the Controller Initialization Block and 
places the Command Queue entry/IOPB at the normal Command Response Block (CRB) location 
in short I/O. 


Offboard Command Response Block 

In order for the board to write a returned lOPB offboard, you need to designate a block of system 
memory for use as an offboard Command Response Block. Then, write a pointer to the block in 
the Controller Initialization Block, and execute the Initialize Controller command. Any non-zero 
value in the pointer field instructs the board to write returned lOPBs to the offboard address. 

Refer to Chapter 3 for additional information on the Command Response Block and Controller 
Initialization in Chapter 5 for additional information on the Controller initialization Block. 

Once you have initialized the board to write command responses to an offboard Command 
Response Block, all responses will be written to this structure unless a bus error occurs during the 
write operation. 


Posting Comm€md Completion 

If the pointer to the external Command Response Block in the Controller Initialization Block 
Is zero, then the board posts command response information in the Command Response 
Block section of Its own short I/O space. 

Once It completes a command, the board DMAs the command response information into 
external memory and then generates a Command Complete Interrupt. 


NOTE; Before reading the command response information in Its own memory, the host 
should first read error status in the board’s onboard Command Response Block (this 
information is inaccessible once the board’s CRBV bit is cleared.) If an error occurs, the 
location of the Command Response Block will depend on the type of error. If the error is 
a SCSI device error, the Command Response Block/returned lOPB will be written offboard 
to the address specified in the Controller Initialization Block. 

On the other hand, if the error status shows that a bus error (BERR*) occurred when 
attempting to move the information into the offboard Command Response Block, then the 
host can find the Command Response Block and lOPB In short I/O at the address 
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specified in the Command Response Block specified in Word 0x6 of the Controller 
Initialization Block offset). 

After checking the error status, the host can respond to the interrupt by clearing the CRBV 
bit (Command Response Block Valid) in the Command Response Status Word of the 
board’s onboard Command Response Block. 


Considerations For Maximizing SCSI Synchronous Data Tranters 

Synchronous data throughput in a SCSI system can be significantly improved by better matching the data 
transfer rates of the host adapter and SCSI devices. This Is because SCSI devices support specific data 
transfer rates within the broad SCSI spectrum. When a synchronous data transfer takes place between 
two SCSI devices, these devices must negotiate between themselves to select a compatible transfer rate. 
If the devices have incompatible transfer rates, the result is significantly lower cable bandwidth. 

This section describes the key factors determining the actual speed at which two SCSI devices will perform 
a synchronous data transfer (as opposed to the rated maximum speeds of the individual devices). Since 
SCSI data transfer rates are negotiated in tenos of nanoseconds (ns) per period instead of frequency, this 
discussion uses the SCSI transfer period to describe transfer rates. The SCSI transfer period is measured 
in 4 nanosecond increments. A resolution of 4r^ results in some strange and difficult to read numbers 
when converted to the equivalent frequency. Just remember that a smaller period means a higher 
frequency, and a larger period means a lower frequency (F=1/T) 


Negotiatian Process Far Synchronous Tranter Redes 

As noted above, the host adapter and target negotiate the maximum transfer rate that may be used 
in data transfers. The negotiation process, which usually occurs the first time the host adapter 
communicates with a target, is essentially as follows: 

1. The host adapter tells the target the smallest transfer period at which the host 
adapter is able to operate. 

2. The target evaluates the received value. 

• If the proposed value is acceptable, the target returns it to the host 
adapter and the negotiation process is finished. 

• If the value is less than the target can handle, the target sends the host 
adapter the smallest transfer period at which it can function. The host 
adapter then accepts that as the correct value, and the negotiation is 
finished. 

Once a data transfer rate has been determined, ail subsequent data transfers between the host 
adapter and target have a transfer period greater than or equal to the agreed-upon value. 

For example, consider a 4 Mbyte/sec. host adapter connected to a 4 Mbyte/sec. disk drive. A 
problem arises in that a 250ns period is not evenly divisible into the 4ns Increments required by 
SCSI. Therefore, some devices express this value as 248ns, while others use 252ns. 
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Assume that both devices use a 248ns period, in this case, the pair will communicate at 4 
Mbytes/sec., because both devices are allowed to transfer at a period greater than the agreed- 
upon value. 

On the other hand, if the host adapter uses 248ns and the drive uses 252ns, the cable rate must 
be less than 4 Mbytes/sec, The 4-nanosecond difference in periods is significant because devices 
do not actually support 4ns steps in transfer rates. The transfer rate is usually determined by some 
division of the oscillator which drives the SCSI controller of the device. Assuming that the SCSI 
controller is driven by a frequency that is twice the agreed-upon transfer rate, the next lower rate 
will be three times the input oscillator. In the example we are currently considering, this would 
mean that the host adapter must operate at 375ns periods or 2.66 Mbytes/sec., considerably less 
than the 4 Mbyte/sec. maximum rate. 

The matching of device data transfer rates becomes particularly important when using the same 
cable to interconnect targets that have different maximum speeds. With this setup, the overall 
system transfer rate is determined by the transfer rates negotiated between the host adapter and 
each of the devices connected to It. The table below lists a variety of "typical" SCSI drives and 
host adapters, along with their associated transfer rates. It is followed by examples of the actual 
transfer rates that would be negotiated between different host adapters and drives In the following 
table. 


Table 6-3. Transfer Periods Of Example SCSI Host Adapters And Drives 


'SCSI Device 

Maximum 
Transfer Rate of 
Device 

Transfer Rate if Target Device 

Cannot Transfer at Maximum Rate 

Drive 1 

212ns (4.72 Mhz) 

252ns (3.97 Mhz) 

Drive 2 

208ns (4.81 Mhz) 

248ns (4.03 Mhz) 

Host Adapter 1 

248ns (4.03 Mhz) 

375ns (2.66 Mhz) 

Host Adapter 2 

200ns (5.00 Mhz) 

300ns (3.33 Mhz) 

Host Adapter 3 

208ns (4.81 Mhz) 

312ns (3.21 Mhz) 

Host Adapter 4 

212ns (4.72 Mhz) 

318ns (3.14 Mhz) 


Example 1: Host Adapter 1, Drive 1 Transfer Rate 252ns; 

The host adapter requests 248ns, which the drive accepts as this is greater than the drive’s 
minimum 212ns period. The actual transfer rate paced by the drive is 252ns. 
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Example 2: Host Adapter 1, Drive 2 transfer rate 248ns: 

The host adapter requests 248ns, which the drive accepts as this is greater than the drive’s 
minimum 208ns period. The actual transfer rate paced by the drive is 248ns. 

Example 3: Host Adapter 2, Drive 1 transfer rate 300ns: 

The host adapter requests 200ns, which the drive rejects as this is less than the drive’s minimum 
212ns period. The drive responds with 212ns. The host adapter must then transfer at its next 
greater period of 300ns. 

Example 4: Host Adapter 2, Drive 2 transfer rate 300ns: 

The host adapter requests 200ns, which the drive rejects as this is less than the drive’s minimum 
208ns period. The drive then responds with 208ns. The host adapter must then transfer at its next 
greater period of 300ns. 

The resulting transfer rates for the remaining combinations are as follows: 

• Host Adapter 3, Drive 1 transfer rate 312ns 

• Host Adapter 3, Drive 2 transfer rate 208ns 

• Host Adapter 4, Drive 1 transfer rate 212ns 

• Host Adapter 4, Drive 2 transfer rate 248ns 

The above examples show that it is possible to achieve similar performance from the two example 
drives with a 4 Mbyte/sec. host adapter. However, if the speed of the host adapter is increased, 
it is not possible to achieve greater performance from both drives on the same cable. Some 
combinations actually hurt performance for some drives. 

This problem is the result of devices having a finite number of actual transfer rates while the SCSI 
specification allows a large number of legal values. It is therefore very important that the system 
integrator carefully choose devices with compatible transfer rates to achieve maximum 
performance. 


Downloading Firmware 

The Download Firmware command allows systems Incorporating the controller to update controller firmware 
without physically replacing the EPROM, either by reprogramming a flash EPROM, or by replacing the 
currently executing firmware memory Image. 

This command allows systems to update the firmware on a controller that is concurrently running systems 
level activity, such as filesystem reads, and writes. This allows the firmware to be updated on the same 
controller that is hosting the storage media containing the new image and minimize the chance of loading 
an Incorrect image. Failure to program the flash EPROM correctly requires replacement of the part; there 
is no way to recover from errors once the part has been misprogrammed. Thus, it is necessary to take 
extreme caution to ensure the integrity of the new firmware load, as well as the correct sequencing of the 
steps necessary to achieve a download. 
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Using this command, the host computer first informs the board that it intends to download new firmware. 
It then transfers the new firmware one packet at a time. The board takes these packets, verifies the 
integrity of each one, and constructs a new memory image in the local buffer memory area. After the entire 
image has been constructed, the host issues a command to either program the flash EPROM, or to replace 
the currently executing program image with the downloadable image. If the board has detected no internal 
Inconsistencies in the buffer memory image that has been created, it performs either the Program Flash 
or Program Memory command. 

Upon receiving a Program Rash command, the board loads the new image into flash EPROM. The next 
time the board is reset, execution will occur from this new image. Until the board is reset, execution will 
occur from the old image, with all commands returned with an appropriate exception notification that the 
executing image fails to match the stored EPROM image. This allows file systems to be mounted on a 
board that has been updated, which can be shut down in an orderly fashion, and the system reset. 

Upon receiving a Program Memory command, the board will replace the currently executing image with the 
new image, which will effect a "warm boot", which will appear to the host Identical to a Reset Controller 
command, issued through the Master Control Register. At this point, the host will need to initialize the 
controller again, and ail work queues before submitting additional commands. 

This command (facility) requires the following: 

• Minimum of 256K of Local Buffer Memory 

• installation of flash EPROM, with associated hardware change (zero ohm register installed), for 
Program Rash capability only. 

To download new firmware to the board, the host needs to start with a file containing an encoded copy of 
the firmware image. Currently, the only encoding format supported is Motorola S-records. Since the 
download facility allows the board to support normal operations while performing the host download, it is 
possible to access this image from a device currently running on the board to be updated. 

First, the host initiates the download by submitting the Host Download command specifying the Initialize 
Download sub-command and set Initialize Download (ID) Bit 4; 
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-- DEBUG 


Figure 6-15. Command Options For Download Firmware Command (Bit 4). 


If this command is successful, the board will return the lOPB using the Normal Completion Vector 
(assuming that Interrupts are enabled). If the board does not have the correct hardware support for Host - 
Download, the lOPB will be returned with the Incorrect Hardware error code. 
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Next the downloads the code, using a series of Transfer Packet sub-commands (Set Transfer Packet (TP) 
Bit 5); 


II I I r II II I I II ' I I “ r ‘ II II I I I I u II 'n "" i i 
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I I-,-1 I I -,-1 I I I I I-1-' I—INTERRUPT ENABLE 

I I I I I I I I '-►RESERVED 

II I III '-►INITIALIZE DOWNLOAD 

II I II I-►TRANSFER PACKET 

II I I (-►PROGRAM FLASH 

II I I-►PROGRAM MEMORY 

I I I I-►RESERVED 

I I (-——MOTOROLA S-RECORDS 

I I-►RESERVED 

I--- ►DEBUG 

Figure 6-16. Command Options For DownLoad Firmware Command (Bit 5). 


Transfer Count: Rll in the number of bytes to be transferred in this packet. 

Buffer Address: Fill in the starting physical (VMEbus) address location of the data. Note that this (address 
+ transfer length) - 1 must exist in a contiguous space; this lOPB does not support scatter/gather lists. 

Check Sum: This field is set to zero. 

Sequence Number. Fill in the packet sequence number. AH packets must be submitted to the board in 
order, with the first Transfer Packet sub-command employing sequence number one (1). 

A Transfer Packet sub-command may fail for a number of reasons. Refer to Chapter 5 {Command Set) 
for details on the types of errors returned and associated conditions. Once an error has occurred, the 
board will abort the entire download procedure, and reset all internal state associated with the process. 
At this point, the only Host Download sub-command with meaning is the Initialize Download sub-command, 
errors are recoverable, and no permanent damage has been done to the electrical system requiring 
physical intervention. 

After ail packets have been transferred, the host may begin loading the transferred Image Into Flash 
EPROM by Issuing a Program Flash sub-command (Set Program Flash (PF) Bit 6): 


i 15 i 14 i 13 i 12 i 11 i 10 i 9 i 8171 6 i 514 i 3 i 2 ii 1 i 0 j 
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i I-1-1 I-,-1 I i I-1-1 1—INTERRUPT ENABLE 

1 I I I I I I I '-►RESERVED 

III I III '-►INITIALIZE DOWNLOAD 

III I II I-►TRANSFER PACKET 

III I I I-►PROGRAM FLASH 

i j i I I_.PROGRAM MEMORY 

I I I I-.RESERVED 

i j I-.MOTOROLA S-RECORDS 

I I-.RESERVED 

I---.DEBUG 

Figure 6-17. Command Options For Download Firmware Command (Bit 6) 


Transfer Count: Fill In the total number of bytes in the firmware load file that were transferred to the board. 
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6 


Sequence Number: Fill in the total number of packets sent. 

If there are any detectable errors up to this point, the board will return the lOPB with an error status code: 
if that code is not Bad EPROM Load (0x9c). the process will be aborted, and the board remains intact, but 
as yet, not updated. 

If. however, the Bad EPROM Load error code is returned, the board attempted to program the flash 
EPROM, and failed. In this case, the EPROM has been damaged beyond recovery, and the physical 
replacement of this part is required. With the error detection and protocol constraints imposed on this 
process, this failure should only occur as a result of internal hardware problems within the board which 
would require direct attention. However, the board will continue to operate, using the old version of 
firmware currently running in static RAM memory, until the next board reset. 

After transferring the data, the host may issue a Program Memory sub-command. The image file for this 
is different than that for Program Rash (Set Program Memory (PM) Bit 7): 


ii 15 i 14 ii 13 i 12 i 111 10 i 9 ii 8 j 7 i 6 ii 5 i 4 i 3 i 2 i 11 0 

» T “ I — " -- I '' '' I " " " I " '' " I " ■ " ■ " r--" -T- 


III'- 
I I I 

1 1 I- 


•—INTERRUPT ENABLE 
—►RESERVED 
—►INITIALIZE DOWNLOAD 
—►TRANSFER PACKET 
—►PROGRAM F1j\SH 

-►PROGRAM MEMORY 

—►RESERVED 
—►MOTOROLA S-RECORDS 


>RESERVED 
»DEBUG 


Figure 6-18. Command Options For Download Firmware Command (Bit 6). 


Since there is no return from this command, there is no reason to fill in the other fields required by the 
Program Rash command. Errors for this command are not fatal; issuing a Reset Controller will reload the 
old version of firmware from the EPROM, and restart the controller using the same firmware that was used 
to download the code. 

After the Program Memory sub-command, the board will attempt to replace the currently executing program 
image with the new downloaded image. In all cases, the contents of the Short I/O will be invalidated. The 
Host Download lOPB encapsulating this sub-command will not be returned to the host. If the board 
successfully loads the new program image, the Board OK bit will be set in the Master Status Register, and 
the host will be able to initialize the controller, just as was done during system initialization. If the Image 
load fails, the Controller Not Available bit will remain set In the Master Status Register. In this case, issuing 
a Controller Reset, through the Master Control Register will cause the old program image to be loaded from 
EPROM. 


System Jnterfiace 

This command fully employs the normal CQE/IOPB command mechanism provided by the board. 
This includes off-board location of both the lOPB and the returned CRB. 
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Application Notes 


This Host Download lOPB does not support scatter/gather lists, but requires all data associated 
with a single lOPB to be located In contiguous memory locations. Since the memory image may 
be transferred using multiple transactions between the host and the board, it is not necessary for 
the entire Image to reside in contiguous memory. 

All Host Download lOPB’s are returned as any other lOPB, using the normal or error vector and 
interrupt level if specified, except the lOPB associated with the Program Memory sub-command. 
When issuing a Program Memory sub-command, no lOPB will be returned, nor interrupt Issued. 
The board will appear to have been reset, and will need to be initialized again. 


MACS! SCSI Synchronous Options 

Since these parameters are at the end of the CIB, the CIB length parameters. Maximum Transfer Length 
in the Initialize Controller command must be specified correctly. The board will use this value to tell 
whether or not to interpret the extra two words as SCSI control parameters. 

The host may read the Device Negotiation Rate information in CSS to verify the results of setting the 
Negotiation Rate parameter. 

There is no way other than using a SCSI bus analyzer to evaluate the effect of setting the Synchronous 
Offset parameter. It is assumed that this would not be set without first consulting such a device. 


Board Identification In BSACSI CSS 

The host may use the contents of this field to determine if a particular Installed controller Is a 4220 Cougar 
11 controller. 
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VMEbus SpecyiccLtions 

DTB Master 

DTB Slave 
Requester 
Interrupter 


SCSI Bus Specifications 

Peripheral Data Rate 


Power Requi r e m e n ts 

Single-Ended V/SCSI-2 4220 Wide 
Motherboard 


Differential V/SCSI-2 4220 Wide 
Motherboard 


Differential V/SCSI-2 4220 Wide 
Daughter Card 


Single-ended V/SCSI-2 4220 Wide 
Daughter Card 


Centronics/Dataproducts Shortline 
Printer Port Daughter Card 




A16, A24. A32, DOS (EO), D16. D32: BLT, D64: 
BLT 

A16, DOS (EO), D16 

Any of R (0-3), Static RWD, ROR 

Any of I (1-7), Dynamic DOS (0) 


Up to lOMbytes/sec synchronous 
Up to SMbytes/sec asynchronous 


5.SA typical @ +5V DC (+/- 5%) 

6.8A maximum @ +5V DC (+/- 5%) 
7.0mA maximum @ +12V DC (+/- 5%) 
30mA maximum @ -12V DC (+/- 5%) 


6.0A typical @ +5V DC (+/- 5%) 

7.0A maximum @ +5V DC (+/- 5%) 
7.0mA maximum @ +12V DC (+/- 5%) 
30mA maximum @ -12V DC (+/- 5%) 


.65A typical @ +5V DC (+/- 5%) 
.90A maximum @ +5V DC (+/- 5%) 


.OSA typical @ +5V DC (+/- 5%) 
.15A maximum @ +5V DC (+/- 5%) 


.70A typical & +5V DC (+/- 5%) 

1 .OA maximum & +5V DC (+/- 5%) 
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Dataproducts Longline 
Printer Port Daughter Card 


Mechanical (Nomin€iU 

Length 

Width 

Thickness 

Weight 


Operating Eiiwironment 

Temperature 
Relative Humidity 
Air Flow 


ReUability 

MTBF per Bellcore 3.0 
TSY-000332 

Single-Ended V/SCSI-2 4220 Wide 
Motherboard 

Differential V/SCSI-2 4220 Wide 
Motherboard 

Single-Ended V/SCSI-2 4220 Cougar II 
Motherboard 

Differential V/SCSI-2 4220 Cougar II 
Motherboard 


0.9A typical 
1.3A maximum 


233 mm 
160 mm 
20 mm 
.45 Kg 


0-55 degrees Centigrade 
10% - 90% Noncondensing 
250 FPM Minimum 


214.5K Hours 


203.3K Hours 


238K Hours 


169.4K Hours 
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Appendix B 

Connector Pinouts and Cabling 


Overview 

This appendix contains the connector pinouts and cabling information needed for various Cougar 11 
configurations. Please refer to the SCSI-2 Specification for more information on cabling. The tables in this 
appendix are listed below. 

SCSI Channels 

• Table B-1 Single-Ended Contact Assignments - SCSI “A" Cable 

• Table B-2 Single-Ended Contact Assignments - SCSI "P" Cable 

• Table B-3 Differential Contact Assignments - SCSI "A" Cable 

• Table B-4 Differential Contact Assignments - SCSI "P" Cable 
RS232 Connector And Cable Pinouts 

• Table B-5 Serial Connector Pinouts (SPA And SPB) 

• Table B-6 Suggested RS232 Cable Pinout 
PI and P2 Connectors 

• Table B-7 P1 Connector Signal Descriptions 

• Table B-8 P2 Connector Signal Descriptions 
P9 Connectors And Cable Pinouts 

• Table B-9 Cable Pinouts For P9 Connector To Dataproducts Short Line Printer 

• Table B-10 Cable Pinouts For P9 Connector To Dataproducts Long Line Printer 

• Table B-11 Cable Pinouts For P9 Connector To Centronics Printer 

Descriptian of SCSI Cables 
SCSI'P" Cable 

The Cougar 11 Wide motherboard and optional Cougar II Wide SCSI daughter card require a standard 
SCSI-2 "P" cable. The single-ended pinout of the cable is shown on page B-4 and the differential is 
on page B-7. 

The cable must have a 68-pin subminiature "D" style connector that mates with the same type 
connector (P8) on the motherboard (or daughter card). Both 8- and 16-bit SCSI devices can be 
connected to the "P" cable. 
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SCSI'A" Cable 

If the board has a Cougar II SCSI daughter card, use a standard SCSI "A" cable to connect it to the 
devices on channel 1. Only 8-blt SCSI devices can be connected to the "A" cable. The single-ended 
pinout of the cable is shown on page B-3 and the differential is on page B-6. 

The SCSI "A" cable is either a 50-conductor flat cable or a 25-signal twisted-pair cable. It is one-to- 
one, with 50-pin connectors on both ends. As per SCSI specifications, the cable can be up to 20 feet 
long (6 meters) for a single-ended SCSI bus and 82 feet long (25 meters) for a differential bus. 

Below is a list of sample part numbers for the SCSI "A" cable which you may find to be useful in 
cabling your system. Interphase assumes no responsibility regarding the functionality of the 
parts listed below. If you need more information concerning the parts, contact the manufacturer 
directly. 


Fiat Cable 
Connectors 

• End of cable connector 


Daisy Chain 


It Sample Part No. 


3M-3365-50 

no center key 

3M-3425-7000 

center key 

3M-3425-7050 

with center key 

Dupont 66900-290 

no center key 

3M-3425-6000 

center key 

3M-3425-6050 

with center key 

Dupont 66900-250 
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Single-Ended SCSI Cable Pinout 

Table B-1 Single-Ended Contact Assignments - SCSI "A“ Cable 



NOTE; 


If no signal is referenced, the Cougar does not use that pin. 
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Table B-2 Single-Ended Contact Assignments - SCSI "P" Cable 


SIGNAL NAME 


CONNECTOR 
CONTACT NUMBER 


CABLE CONDUCTOR NUMBER 


CONNECTOR 
CONTACT NUMBER 


SIQNAL NAME 
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Pinouts and Cabling 


NOTES 


(1) The minus sign next to a signal indicates active low. 

(2) The conductor number refers to the conductor position when using 
0.025- inch centerline flat ribbon cable. Other cable types may be used 
to implement equivalent contact assignments. 

(3) Devices which connect to the P-cable shall leave the following signals 
open: -DB(12), -DB(13). -DB(14), -DBOS), -DB(P1). -DB(8). 

-DB(9), -DB(10), and -DB(11). 

All other signals shall be connected as defined. 
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Differential SCSI CahXe Pinout 


Table B-3 Differential Contact Assignments - SCSI "A" Cable 


Pin 

Mnemonic 

Pin 

Mnemonic 

1 

SHIELD 

2 

GNO 

3 

DBO* 

4 

OBO- 

5 

DBU 

6 

OBI- 

7 

DB2-I- 

8 

DB2- 

9 

DB3-t- 

10 

DB3- 

11 

0B4-^ 

12 

DB4- 

13 

0B5-I- 

14 

DBS- 

15 

0B6-f 

16 

0B6- 

17 

DB7+ 

18 

DB7- 

19 

DBP+ 

20 

DBP- 

21 


22 

GNO 

23 


24 


25 

TERMPWR 

26 

TERMPWR 

27 


28 


29 

ATN+ 

30 

ATN- 

31 

GND 

32 

GNO 

33 

BSY+ 

34 

BSY- 

35 

ACK-t- 

36 

ACK- 

37 

RST+ 

38 

RST- 

39 

MSG-^ 

40 

MSG- 

41 

SEL+ 

42 

SEL- 

43 

C/D+ 

44 

C/D- 

45 

REQ+ 

46 

REQ- 

47 

1/0+ 

48 

I/O- 

49 

GND 

50 

GND 


NOTE: If no signal is referenced, the Cougar does not use that pin. 
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Pinouts and Cctbling 


Table B-4 Differential Contact Assignments > SCSI T" Cable 
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NOTES 


(1) The conductor number refers to the conductor position when using 
0.025- inch centerline flat ribbon cable. Other cable types may be used 
to implement equivalent contact assignments. 

(2) 8 bit devices which connected to the P-cable shall leave the following 
signals open: -DB(12). -DB(13). -DB(14), -DB(15). -DB(P1). -DB(8). 
-DB(9). -DB(10). -DB(11). +DB(12), +DB(13), +DB(14), +DB(15). 
+DB(P1), +DB(8), +DB(9), +DB(10) and +DB(11) 


All other signals shall be connected as defined. 















Pinouts and Cabling 


RS232 Connector and Cable 

Table B-5 Serial Connector Pinouts (SPA and SPB) 


PIN 

MNEMONIC 

TYPE 

DESCRIPTION 

1 

- 

. 

Unconnected (DCO) 

2 

DSR 

1 

Data Set Ready 

3 

RXD 

1 

Receiver Data Input 

4 

RCTS 

I/O 

RTS/CTS. (shorted to pin 6) 

5 

TXD 

O 

Transmitter Data Output 

6 

RCTS 

IA3 

RTS/CTS. (shorted to pin 4) 

7 

DTR 

O 

Data Terminal Ready 

8 

- 

- 

Unconnected (Rl) 

9 

GNO 

• 

Slcpial Ground 

10 

- 

- 

Unconnected 


The same cable for the second Serial Port for PC compatible systems can be used for the V/SCSI-2 4220 
Cougar II. This cable can be built or bought off-the-shelf from many computer stores. The cable pinout 
is shown in the following table: 

Table B-6 Suggested RS232 Cable Pinout 


10-PIN 

DB-2S PIN 

MNEMONIC 

DESCRIPTION 

1 

8 

DCD 

Data Carrier Detect 

2 

6 

DSR 

Data Set Ready 

3 

3 

RXD 

Receiver Data Input 

4 

4 

RTS 

Request to Send 

5 

2 

TXD 

Transmitter Data 

6 

5 

CTS 

Clear To Serxi 

7 

20 

DTR 

Data Terminal Ready 

8 

22 

Rl 

Ring Indicator 

9 

7 

GND 

Signal Ground 

10 

• 

- 

Unconnected 


Both RS232 ports on the Cougar are configured as Data Terminal Equipment (DTE). With this connector 
and cable configuration, a NULL modem cable may be required to connect a terminal to the board. 














































































Appendix 


B 


PI Connector 


Table B-7 VMEbus P1 Connector 


Pin 

Row A Signal Mnamonle 

Row B Signal Mnamonle 

Row C Signal Mnamonle 

1 

OOO 

BBSY* 

008 

2 

001 

BCLR* 

009 

3 

002 

ACFAIL* 

01O 

4 

003 

BQOIN* 

Oil 

5 

004 

BQOOUT* 

012 

6 

005 

BQ1IN* 

013 

7 

006 

BQiour 

014 

8 

007 

BQ2IN* 

01S 

9 

QNO 

BQ20ur 

QNO 

10 

SYSCLK 

BQ3iN* 

SYSFAIL* 

11 

QNO 

BQ3our 

BERR* 

12 

osr 

BRO* 

SYSRESET* 

13 

DSO* 

BR1* 

LWORD* 

14 

WRITE 

BR2* 

AMS 

IS 

QNO 

BR3* 

A23 

16 

OTACK 

AMO 

A22 

17 

QNO 

AMI 

A21 

18 

AS* 

AM2 

A20 

19 

QNO 

AM3 

A19 

20 

lACK 

QNO 

A18 

21 

lACKIN* 


A17 

22 

lACKOUr 


A16 

23 

AM4 

QNO 

A1S 

24 

A07 

iRor 

A14 

25 

A06 

IRQ6* 

A13 

26 

AOS 

IRQS* 

A12 

27 

A04 

IRQ4* 

All 

28 

AOS 

IRQ3* 

A10 

29 

A02 

IRQ2* 

A09 

30 

A01 

IRQ1* 

AOS 

31 

-12V OC 


♦ 12V DC 

32 

♦SV OC 

♦5V OC 

*5V DC 


NOTE: If no signal is referenced, the Cougar does not use that pin. A denotes an active low signed. 

















































































































Pinouts and Cdbling 


P2 Connector 

Table B-8 VMEbus P2 Connector (Row B Only Motherboards) 



NOTE: If no signal is referenced, then the board does not use that pin. Variations of the Cougar II that use P2 rows A 

and C are not currently available. 
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Dataproducts Printer C€ibling 


This section applies only to motherboards which are set up to use the secondary channel (port 1) with a 
short line or long line Dataproducts printer. The printer port daughter card is installed and configured as 
described in the Installation chapter. This section does not apply to boards with a SCSI daughter card or 
no daughter card. 


Dataproducts Cable Description 

To connect a Dataproducts printer to the board, use a 50-conductor flat ribbon cable with a 50-pin 
connector that mates with the J9 connector of the printer daughter card installed on the board. Refer 
to the list below for sample cable/connector part numbers. 

The cable pinouts depend on the type of Dataproducts printer being used: short line or long line. The 
pinout for Short Line printers is shown in Table B-9. The Longline pinout appears in Table B-10. 

The following is a list of sample part numbers which you may find to be useful to make the printer 
cable. Interphase assumes no responsibility regarding the functionality of the parts listed 
below, if you need more information concerning the parts, contact the part manufacturer 
directly. 

Component Sample Part No. 

Fiat Cable 3M-3365-50 

Connectors 

• Motherboard End without strain 

relief; with center key 

• Dataproducts End 


NOTE 


Dupont 66900-290 
T&B Ansley 609-50P 


The connector type needed for your specific Dataproducts printer 
may be different from that given above. Be sure to verify your 
printer’s connector requirements before making the cable. 
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Table B-9 Cable Pinouts For P9 Connector To Dataproducts Short Line Printer 


4220 

P9 

Dataproducts 
(Short Line) 

Function 

4220 

P9 

Dataproducts 
(Short Line) 

Function 

6 

19 

DATA 1 

11 

37 

RETURN 

7 

3 

RETURN 

42 

31 

BUFFER CLEAR 

9 

20 

DATA 2 

43 

15 

RETURN 

10 

4 

RETURN 




1 

1 

DATA 3 

15 

22 

READY 

4 

2 

RETURN 

16 

6 

RETURN 

23 

41 

DATA 4 

12 

21 

ON LINE 

20 

40 

RETURN 

13 

5 

RETURN 

2 

34 

DATA 5 

18 

23 

DEMAND 

3 

18 

RETURN 

19 

7 : 

RETURN 

29 

43 

DATA 6 

30 

27 

PARITY ERROR 

26 

42 

RETURN 

31 

11 

RETURN 

8 

36 

DATA 7 

24 

25 

BOTTOM OF FORM 

5 

35 

RETURN 

25 

9 

RETURN 

33 

28 

DATA 8 

27 

26 

PAPER MOVING 

32 

44 

RETURN 

28 

10 

RETURN 

36 

29 

DATA PARITY 

17 

39 

GROUND 

37 

13 

RETURN 

21 

24 

TOP OF FORM 

39 

30 

PAPER INSTRUCTIONS 

22 

8 

RETURN 

40 

14 

RETURN 

38 

46 

INTERFACE CONNECTED 

14 

38 

DATA STROBE 

35 

45 

INTERFACE CONNECTED RETURN 


NOTE: If no signal is referenced, that pin is not used. 
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Table B-10 Cable Pinouts For P9 Connector To Dataproducts Long Line Printer 


4220 

P9 

Dataproducts 
(Long Line) 

Function 

4220 

P9 

Dataproducts 
(Long Line) 

Function 

6 

19 

DATA U 

11 

37 

DATA STROBE- 

B 

3 

DATA 1- 

42 

31 

BUFFER CLEAR+ 

9 

20 

DATA 2+ 

43 

15 

BUFFER CLEAR- 

10 

4 

DATA 2- 




1 

1 

DATA 3+ 

15 

22 

READY+ 

4 

2 

DATA 3- 

16 

6 

READY- 

23 

41 

DATA 4+ 

12 

21 

ON LINE-f 

20 

40 

DATA 4- 

13 

5 

ON LINE- 

2 

34 

DATA 5+ 

18 

23 

DEMAND-)- 

3 

18 

DATA 5- 

19 

7 

DEMAND- 

29 

43 

DATA 6+ 

30 

27 

PARITY ERROR-)- 

26 

42 

DATA 6- 

31 

11 

PARITY ERROR- 

8 

36 

DATA 7+ 

24 

25 

BOTTOM OF FORM-)- 

5 

35 

DATA 7- 

25 

9 

BOTTOM OF FORM- 

33 

28 

DATA 8+ 

27 

26 

PAPER MOVING-)- 

32 

44 

DATA 8- 

28 

10 

PAPER MOVING- 

36 

29 

DATA PARITY+ 

17 

39 

GROUND 

37 

13 

DATA PARITY- 

21 

24 

TOP OF FORM-)- 

39 

30 

PAPER INSTRUCT10NS+ 

22 

8 

TOP OF FORM- 

40 

14 

PAPER INSTRUCTION- 

38 

46 

INTERFACE CONNECTED 

14 

38 

DATA STROBE+ 

35 

45 

INTERFACE CONNECTED 
RETURN 


NOTE: If no signal is referenced, that pin is not used. 
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Centronics Printer Cabling 

Table B-11 Cable Pinouts For P9 Connector To Centronics Printer 


4220 P9 


6 


Centronics 


2 


20 


3 


21 



Function 


DATA 1 


RETURN 


DATA 2 


RETURN 


DATA 3 


RETURN 


DATA 4 


RETURN 


DATA 5 


RETURN 


DATA 6 


RETURN 


DATA? 


RETURN 


DATA 8 


RETURN 


NOT USED 


NOT USED 


NOT USED 


NOT USED 


DATA STROBE 


4220 P9 

Centronics 

Function 

11 

19 

RETURN 

42 

31 

PRINTER INITIALIZE 

43 

30 

RETURN 

34 

NU 

NOT USED 

15 

32 

FAULT 

16 

NU 

NOT USED 

12 

13 

SELECT 

13 

NU 

NOT USED 

18 

10 

ACKNOWLEDGE 

19 

28 

RETURN 

30 

12 

PAPER EMPTY 

31 

NU 

NOT USED 

24 

NU 

NOT USED 

25 

NU 

NOT USED 

27 

11 

BUSY 

28 

29 

RETURN 

17 

NU 

NOT USED 

21 

NU 

NOT USED 

22 

NU 

NOT USED 

38 

NU 

NOT USED 

35 

NU 

NOT USED 
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Appendix C 
Error Codes 


The Return Status word in the command response contains information pertaining to the status of the lOPB 
returned in the Command Response Block. Error codes have been separated into logical groups and are 
reported in hexadecimal format. 

BiACSI/ControUer Envr Codes 

HEX CODE DESCRIPTION 

0x00 GOOD STATUS: 

The controller has completed the command and no errors were detected. The 
Pass-Back status field contains the SCSI Pass-Through status. 

0x01 QUEUE FULL: 

The work queue specified for this command is full and cannot receive another entry. 
The command is not executed and is moved directly to the Command Response 
Block with this status set. The queue can receive another entry after a currently 
active command has completed or if the queue is flushed. 

0x02 WORK QUEUE INITIALIZATION ERROR: 

The work queue specified has not been initialized. The command is not executed 
and is moved directly to the Command Response Block with this status set. The 
Work Queue should be initialized wrth an Initialize Work Queue Command. 

0x05 QUEUE NUMBER ERROR: 

The work queue number specified in the Command Queue entry is invalid. Valid 
work queue numbers are 0 to 14 for Cougar II and 0 to 255 for Cougar II Wide. 

0x06 QUEUE ALREADY INITIALIZED: 

The work queue specified to be initialized has already been initialized. To re-initialize 
a queue, set the Initialized Work Queue bit In the options field of the Initialize Work 
Queue Command. 

0x07 QUEUE UNINITIALIZED: 

An lOPB was issued to a work queue that has not been Initialized. Work queues 
must be initialized with operating parameters before usage. The Work Queue should 
be initialized with an Initialize Work Queue Command. 

0x08 QUEUE MQDE NOT READY: 

The Start Queue Mode bit was set before the Initialize Controller Command was 
issued. The Initialize Controller Command should be the first board operation after 
power up to configure the MACSI interface. 
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0x09 COMMAND UNAVAILABLE: 

The command specified has not been implemented in the current firmware. 

General Error Code Inftjrmatum 

0x10 RESERVED FIELD ERROR: 

A reserved field in the lOPB has non-zero data in it. 

0x11 RESET BUS STATUS: 

The SCSI Reset lOPB has executed successfully and generated a Reset on the bus. 

0x12 SECONDARY PORT UNAVAILABLE: 

An lOPB has been issued to the secondary port (Port 1), but the daughter card is not 
installed. 

0x13 SCSI ID ERROR: 

The SCSI device ID requested is the board’s own device ID. All devices on the bus 
require unique SCSI Device IDs. 

0x14 SCSI BUS RESET STATUS: 

The command could not execute because the SCSI bus is held In the reset state. 
This may be caused by an un-powered device on the bus, improper termination, or 
an inverted cable. 

0x15 COMMAND ABORTED BY RESET: 

The command has been aborted due to a SCSI reset condition received during 
execution of the command. 

0x16 PAGE SIZE ERROR: 

The page size specified in the Page Size field of the Controller Initialization Block 
(words OxD - OxE) Is invalid. For most applications, this field must be 0. 

0x17 INVALID COMMAND TAG: 

Command tags must be non-zero for successful searches. 

0x18 BUSY COMMAND TAG: 

Command is on the bus. 
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Eirror Codes 


0x19 

VMEbus Errors 

0x20 

0x24 

0x26 

0x28 

0x2C 

0x2E 

SCSIErrors 

0x30 


lOPB PARAMETER ERROR: 

The lOPB contains a value in one of its parameter fields which prevents the proper 
execution of the lOPB (e.g. invalid memory type, illegal address, etc.). 


VMEbus BUS ERROR: 

This error indicates that a bus error occurred during the DMA transfer of the data to 
or from the buffer or the bus. This is typically caused by a nonexistent address or 
address modifier in the lOPB. 

lOPB PARAMETER ERROR: 

The lOPB contains a value in one of its parameter fields which prevents the 
execution of the lOPB (e.g. invalid memory type, illegal address, etc.). 

VMEbus FETCH ERROR: 

A VMEbus error occurred during an offboard lOPB fetch. 

VMEbus POST ERROR: 

A VMEbus error occurred on an offboard Command Response Block post. 

VMEbus SCATTER/GATHER FETCH: 

VMEbus error on scatter/gather list fetch. 

INVALID SCATTER/GATHER COUNT: 

An invalid number of scatter/gather elements has been specified. Valid element 
counts are 1 to 256. 


SCSI SELECTION TIMEOUT ERROR: 

The selection phase of the SCSI device has failed. The error may occur due to an 
incorrect SCSI Target ID. 
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0x31 SCSI DISCONNECT TIMEOUT ERROR: 

A disconnected device has not re>selected the board in the timeout period. This may 
be caused by a hardware error, or a command that may take a very long period of 
time to execute. 

0x32 ABNORMAL SCSI SEQUENCE: 

The SCSI operation did not complete successfully due to a hardware error or an 
abnormal operation sequence. 

0x33 SCSI DISCONNECT ERROR: 

An invalid SCSI bus sequence has been detected. This usually indicates a device 
has disconnected without either issuing the disconnect or command complete 
message. 

0x34 SCSI TRANSFER COUNT EXCEPTION: 

The SCSI data transfer Count did not match the count specified in the Maximum 
Count Length field of the lOPB. The amount of data actually transferred on the SCSI 
bus will be returned in the Maximum Transfer Length field. This status may not be 
considered an error for commands that intentionally allocate more buffer than the 
SCSI command uses. 

0x35 SCSI PARITY ERROR: 

A parity error occurred during the Information Transfer phase on the SCSI bus. 

0x36 GROSS SCSI ERROR 

The SCSI controller has detected an anomalous condition. A SCSI bus reset is 
required. 

0x37 SCRIPT ILLEGAL INSTRUCTION 

The SCSI controller has detected an illegal instruction. REQ may have been 
asserted when a disconnect was expected. A SCSI bus reset is required. 

0x38 INVALID CDB LENGTH 

Claculated CDB Lengeth for user-defined command (group 6 or 7) is less than 1 or 
greater than 24. 

0x39 INVALID WIDE SCSI ID 

Valid SCSI IDs for this board are 0-7 only. 
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Error Codes 


Scatter/Gather Errors 

0x40 0 COUNT SCATTER/GATHER DETECTED 

Scatter/Gather elements with 0 count detected. 

0x41 ILLEGAL SCATTER/GATHER MEMORY TYPE 

Illegal memory type in scatter/gather list. 

0x43 SCATTER/GATHER ELEMENT COUNTS < TOTAL TRANSFER COUNT 


Eirror Handling (^odes 


0x50 


0x51 


0x80 


0x81 


0x82 


0x83 


0x84 


READ/WRITE BUFFER COUNT ERROR: 

Buffer count is too large. 

ILLEGAL READ/WRITE: 

Can’t execute because of offboard Command Response Block. 

FLUSH ON ERROR IN PROGRESS: 

This status is set when the lOPB is flushed because an error condition has occurred 
and the work queue has the abort enable option set. This causes all queued lOPBs 
to be flushed until the abort acknowledge has been received. 

FLUSH WORK QUEUE STATUS: 

The queued lOPB is being flushed in response to a Flush Work Queue Command. 
MISSING COMMAND: 

A device has reselected the board for which there is no currently pending command. 
COUNTER EXHAUSTED: 

The transfer counter has exhausted but more data is being requested by the target 
device. A SCSI bus reset is required. 

DATA DIRECTION ERROR: 

A data phase is being requested opposite the direction set in the lOPB. A SCSI bus 
reset is required. 
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FirnwJiMre Iknvnlo€ui Errors 

0x90 INCORRECT HARDWARE: 

Returned if the board either has insufficient memory, or is not populated with FLASH 
EPROM. 

0x91 INVALID RECORD FORMAT: 

Returned if the Command Options word fails to specify a supported record type 
encoding. Currently, the only format supported Is Motorola S-records. 

0x92 ILLEGAL lOPB VALUE: 

Returned if any one of the lOPB fields contains an obviously incorrect value. 

0x94 INVALID DOWNLOADED OPERATION: 

A Transfer Packet sub-command has been received after a download process has 
been correctly executed. 

0x95 BAD SEQUENCE NUMBER: 

The board has received a packet from the host out of sequence. 

0x96 BAD CRC: 

The calculated checksum for the packet fails to match the value specified in the 
lOPB. 

0x97 TRANSLATION ERROR: 

The board encountered an error translated the downloaded data into an actual 
memory image. 

0x99 BAD PACKET COUNT: 

The number of packets received via Transfer Packet sub-commands does not match 
the count specified in the Transfer Count field of the lOPB. 

0x9A BAD TRANSFER COUNT: 

The total number of bytes received via Transfer Packet commands does not match 
the total byte count specified in the Transfer Count field of the Initialize Flash sub¬ 
command. 
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0x9B BAD EPROM CHECKSUM: 

After translating the downloaded data into a memory image, the internal checksum 
of the EPROM Image failed. 

0x9C ILLEGAL IMAGE: 

Returned if the submitted image fails to match the requested action. The Program 
Flash request requires a different image than a Program Memory request. 

0x9D BAD EPROM LOAD: 

The board failed to program the FLASH EPROM. The error is not recoverable, and 
the EPROM must be replaced. 


Other Errors 

OxCO BAD lOPB TYPE: 

The lOPB type field does not match a currently supported lOPB type. 

0xC1 lOPB TIMEOUT ERROR 

The lOPB has timed out due to some type of serious error. 

Ntm-Recaverable SCSI Errors 
ERROR DURING MESSAGE IN PHASE 
0X800 ILLEGAL FATAL SCSI ERROR CODE 

This error should not occur. 

0x801 BAD SYNCHRONOUS MESSAGE: 

The message received in response to a synchronous negotiation did not contain a 
synchronous negotiation message. 

0x802 BAD WIDE MESSAGE: 

The message received In response to a wide negotiation did not contain a wide 
negotiation message. 

0x803 UNKNOWN MESSAGE REJECT: 

The board received a message reject for a message that is mandatory for the target 
to implement. 

0x804 MESSAGE REJECT IN COMMAND PHASE: 
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The board received a message reject in response to a command byte. 

0x805 MESSAGE REJECT NOT IN MESSAGE OUT PHASE; 

The board received a message reject in response to something other than a 
message out. 

0x806 

UNIMPLEMENTED MESSAGE: 

The board received a message that has not been implemented. 

TARGET SEQUENCE ERRORS 

0x820 RESELECTION. NO IDENTIFY: 

The target did not send an identify message after reselecting the board. 

0x821 RESERVED PHASE DETECTED: 

The target switched into a reserved phase. 

SCSI Bus Interniptums 

0x840 INVALID MESSAGE OUT PHASE: 

The target switched to message out phase without the board asserting ATN. 

0x841 EXTRA SCSI STATUS AFTER SELECTION: 

After the board selected a device, but before the identify message out, the board 
detected anomalies on the SCSI bus. 

0x842 GLITCH IN NON-DATA PHASE: 

The SCSI phase lines glitched while REQ was asserted in a phase other than data 
in or data out. 

0x843 INVALID TIMEOUT: 

The SCSI selection timer expired on the board for some reason other than selection 
timeout. 
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CO# 

1 DATE APPROVED: 

1 DATE WRITTEN: 

4167 

1 1996-08-01 10:52 

1 1996-07-22 14:51 

MARKETING NUMBER 

P-NUMBER 


4220 

186 


4220W 

192 

OLD REVISION 

NEW REVISION 

DESCRIPTION 

FA00084-A23 

FA00084-D00 

COUGAR2 EPROM 

FA00085-A23 

FA00085-D00 

COUGAR2 EPROM (FLASH) 

SX00086-A23 

SX00086-D0O 

COUGAR2 MEMORY DNLD 

SX00087-A23 

SX00087-D00 

COUGAR2 FLASH DNLD 


I —SYMPTOM/CAUSE/SOLUTION SECTION— 

I 

REASON FOR CHANGE(S) : (Be specific) 

( 1 ) 

Symptom : Controller does not time out on an lOPB when the timeout value in 
the initialize work queue is greater than Oxlfff. 

Cause : An older fix in the code to make it Jaguar(4210) compatable limited 
the timer values. 

Solution: Correct the firmware to match the user documentation. 


( 2 ) 

Symptom : The timer values issued in the initialize work queue command are not 
reported correctly in the dump work queue parameters command. 

Cause : An older fix in the code to make it Jaguar(4210) compatable limited 
the timer values to 16 bit entities. 

Solution: Correct the firmware to match the user documentation. 


(3) 

Symptom : SCSI bus hang. 

Cause : If the controller was starting a muliple byte message out sequence to 
the target and the target goes status phase after the first byte, the 
controller fails to remove the ATN (attention) signal from the SCSI bus. 
The ATN was for the message out phase to indicate that it was a multiple 
byte message. 

Solution: Correct the SCSI scripts to clear ATN when going to status phase. 


(4) 

Symptom : The times they are a changing. 

Cause : Older tools get harder to maintain. 

Solution: Convert the FA00084-Axx code to the new GCC/GDB compiler/tools. This 
is the reason for the jump from Axx to Dxx revisions. 
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CO# 

1 DATE APPROVED: 

1 DATE WRITTEN: 

3822 

1 1996-02-23 09:32 

1 1995-11-29 16:02 

MARKETING NUMBER 

P-NUMBER 


4220 

186 


4220W 

192 

OLD REVISION 

NEW REVISION 

DESCRIPTION 

FA00084-A22 

FA00084-A23 

COUGAR2 EPROM 

FA00085-A22 

FA00085-A23 

COUGAR2 EPROM (FLASH) 

SX00086-A22 

SX00086-A23 

COUGAR2 MEMORY DNLD 

SX00087-A22 

SX00087-A23 

COUGAR2 FLASH DNLD 


I —SYMPTOM/CAUSE/SOLUTION SECTION-- 

I 

REASON FOR CHANGE(S) : (Be specific) 

Symptom : SCSI bus hangs. 

Cause : When handling a message in phase change for a disconnect and the 

front end chip was an NCR 53c710, the code would acess the device as 
an NCR 53c720 causing register corruption. 

Solution: Correct the code to check the config structure before doing register 
accesses. 







Directory for 4220/4220W Firmware: 


8/1/96: 

fa00084.d00 is a SRECORD file for programming EPROMs 

fa00087.d00 is a SRECORD file for downloading to 4220 FLSH memory 

02README.txt details of changes for "DOO" release. 

2/23/96: 

fa00084.a23 is a SRECORD file for programming EPROMs 

fa00087.a23 is a SRECORD file for downloading to 4220 FLSH memory 

01README.txt details of changes for "A23" release. 
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